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Directive 


Abbreviation 

Page 

*ABBREV 


none 

3-14 

*ADDFILE 

Ifn.name 

*AF 

3-5 

*BEFORE 


★B 

3-6 

*C4LL 

deck 

*CA 

3-11 

*CHANG£ 

oldld ,newld , •«• lOldid ytievld 

*CK 

3-6 

*C(MDECK 

deck,NOPROP 

★CD 

3-5 

★COMPILE 

deckl«deck2 

*C 

3-11 

★COMPILE 

deckl,deck2, • • • ,deckn 

★C 

3-11 

★COPY 

deck,line 

*CY 

3-6 

★COPY 

deck,line 1 ,Iine2 

*CY 

3^ 

★COPY 

deck,Ilnel,llne2,lfn 

★CY 

3-6 

★CWEOR 

level 

★cw 

3-11 

★DECK 

deck 

★DK 

3-5 

★DECLARE 

deck 

★DC 

3-i5 

★DEFINE 

nameX,name2^ » ^ 

*DF 

3-15 

★DELETE 

linel,line2 

★D 

3-7 

★DELETE 

line 

★D 

3-7 

★DO 

Iden11, iden12,. •.,Iden tn 

none 

3-12 

★DONT 

ident l,ident2,. ^• jldentn 

*DT 

3-12 

★END 


none 

3-15 

★ENDIF 


★El 

3-12 

★ENDTEXr 


*ET 

3-14 

★IDENT 

idnaiae,B»niini,K*ident ,U»ident 

*ID 

3-7 

★IF 

type,name ,ni]m 

none 

3-12 

★IF 

* type, name ,n urn 

none 

3-12 

★INSERT 

line 

★I 

3-8 

★LIMIT 

n 

★LT 

3-15 

★LIST 


★L 

3-14 

★MOVE 

deckl,deck2 

★M 

3-8 

★NOABBREV 


★NA 

3-14 

★NOLIST 


★NL 

3-14 

★PULIMOD 

identl ,ident2, .* * ,identn 

★PM 

3-15 

★PURDECK 

deckX,deck2, . •. ,deckn 

★PD 

3-8 

★PURDECK 

deckX*deck2 

*PD 

3-8 

★PURGE 

identi,ldent2, * . • ,ldentn 

★P 

3-9 

★PURGE 

ident l.ident2 

*P 

3-9 

★PURGE 

ident ,★ 

★P 

3-9 

★READ 

Ifn 

★RD 

3-13 

★RESTORE 

line 

★R 

3-9 

★RESTORE 

lineX,Iine2 

★R 

3-9 

★REWIND 

Ifn 

★RW 

3-13 

★SELPURGE 

deck.ident I ,deck2*ldent 2, • •. ,deckn .identn 

★SP 

3-9 

★SELYANK 

deckirident X,deck2.ident2, •. • ,deckn .identn 

*SY 

3-10 

★SEQUENCE 

deck X ,deck2, • • • ,deckn 

*S 

3-10 

★SEQUENCE 

deckX.deck2 

*S 

3-10 

★SKIP 

lfn,n 

*SK 

3-14 

★TEXT 


★T 

3-14 

★WEOR 

level 

★W 

3-13 

★WIDTH 

llnelen,ldlen 

*WI 

3-13 

★YANK 

identX,ident2, ••• ,identn 

*Y 

3-10 

★YANK 

identl.ident2 

*Y 

3-10 

★YANKDECK 

deck!,deck2,•••,deckn 

★YD 

3-10 

*/ 

comments 

none 

3-16 
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This manual describes the Update utility for main¬ 
taining and updating decks in compressed symbolic 
format on mass storage. As described in this 
publication, Update 1-4 operates under the control 
of the following operating systems: 

9 NOS 1 and NOS 2 for the CONTROL DATA® CYBER 180 
Computer Systems; CYBER 170 Computer Systems; 
CYBER 70 Computer System models 71, 72, 73, and 
74; and 6000 Computer Systems. 

9 NOS/BE 1 for the CDC® CYBER 180 Computer Sys¬ 
tems; CYBER 170 Computer Systems; CYBER 70 
Computer System models 71, 72, 73, and 74; and 
6000 Computer Systems. 

9 SCOPE 2 for the CDC CYBER 170 Computer System 
model 176; CYBER 70 Computer System model 76; 
and 7600 Computer Systems. 

The user is 'assumed to be familiar with the oper¬ 
ating system and computer system in use. 


The NOS 1, NOS 2, and NOS/BE Manual Abstracts are 
pocket-sized manuals containing brief descriptions 
of the contents and intended audience of NOS and 
NOS/BE and all the product set manuals of these two 
operating systems. The manual abstracts can be 
useful in determining which manuals are of greatest 
interest to a particular user. 

The Software Publications Release History serves as 
a guide in determining which revision level of 
software documentation corresponds to the Program¬ 
ming System Report (PSR) level of installed site 
software. 


The users of Update can find additional pertinent 
information in the Control Data Corporation manuals 
listed below. The manuals are listed alphabetically 
within groupings that indicate relative importance 
to readers of this manual. The applicable oper¬ 
ating systems are also Indicated. 


The following manuals are of primary interest: 

Publication 

Publication Number NOS 1 NOS 2 NOS/BE 1 SCOPE 2 

NOS Version 1 Reference Manual, 

Volume 1 of 2 60435400 X 

NOS Version 2 Reference Set, Volume 3 

System Commands 60459680 X 

NOS/BE Version 1 Reference Manual 60493800 X 

SCOPE Version 2 Reference Manual 60342600 X 


The following manuals are of secondary interest: 


Publication 

Publication 

Number 

NOS 1 

NOS 

NOS Version 1 Diagnostic Index 

60455720 

X 


NOS Version 2 Diagnostic Index 

60459390 


X 

NOS/BE Version 1 Diagnostic Index 

NOS Version 1 Manual Abstracts 

60456490 

84000420 

X 


NOS Version 2 Manual Abstracts 

60485500 


X 

NOS/BE Version 1 Manual Abstracts 

Software Publications Release History 

84000470 

60481000 

X 

X 


NOS/BE 1 SCOPE 2 

X 


X 

X X 
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CDC manuals can be ordered from Control Data Corporation, 
Literature and Distribution Services, 308 North Dale Street, 
St. Paul, Minnesota 55103. 


This product is intended for use only as 
described in this document. Control Data can¬ 
not be responsible for the proper functioning 
of undescribed features or parameters. 
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NOTATIONS 


Throughout this manual, the following conventions 
are used to present Update directives: 

UPPERCASE Uppercase letters Indicate words, 
acronyms, or mnemonics either re¬ 
quired by Update or produced as 
output by Update. All words printed 
entirely in uppercase letters have a 
preassigned meaning to Update. 
These words include command verbs 
and keywords. 

lowercase Lowercase words identify variables 
for which values are supplied by the 


Update user or by Update as output. 
These words generally indicate the 
nature of the Information they rep¬ 
resent (numerical value, file or job 
name, and so forth). 

... Ellipsis Indicate that omitted 

entities repeat the form and func¬ 
tion of the last entity given. An 
ellipsis immediately following a 
command element indicates it can be 
repeated at your option. 

A The delta symbol represents a blank 

used as a separator. 
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INTRODUCTION 


1 


Update is a utility for maintaining and manip¬ 
ulating a mass storage file containing images of 
coded punched cards or text lines. Once these 
images have been made a part of an Update program 
library, physical punched cards or lines can be 
eliminated. Update can maintain b-bit (display 
code) line images and 8-bit (ASCII) line images on 
the same program library. Line images can be as 
long as 256 characters. The length of line images 
written to the compile file can be controlled by an 
Update directive. The entire line appears in the 
output listing. 

A file of line images to be manipulated by Update 
must be in a special format known as a program 
library. Three types of Update runs generate or 
manipulate a program library: 

• A creation run generates a program library from 
the input stream text. 

• A correction run manipulates the contents of an 
existing program library. 

o A copy run changes the format of a program 
library from random to sequential or from 
sequential to random. 

A separate new program library can be created with 
a correction run; the changes made during the 
correction run are permanently recorded in the new 
program library. Changes made during a correction 
run never permanently alter the existing program 
library. The changes become permanent only through 
the creation of a new program library. 

As each line image is written to the program 
library, Update assigns it a unique identifier. 

Groups of line images within the program library 
are known as decks. Each program library must have 
at least one deck; the maximum number of decks is 
262143. Deck grouping is significant in terms of 
extracting line images from the program library in 
a format suitable for use by a compiler, assembler, 
or print routine. While an individual line can be 
referenced for purposes such as deletion of that 
line or insertion after that line, the smallest 
unit that can be extracted from the program library 
is the deck. Program libraries can be maintained 
either in the display code or ASCII character set. 
All ASCII input or output codes are 8-bit charac¬ 
ters, right-justified in a 12-bit byte (ASCII 8/12). 

Typically, use of Update involves maintenance of a 
group of compiler or assembly language routines, 
For convenience, the programmer often specifies 
each routine or group of related routines as an 
individual deck. One routine can then be changed 
or extracted without affecting other routines in 
the program library. Because each line image in a 
deck has its own identifier (a deck name) and an 
Update-supplied sequence number, the line image can 
be referenced individually in order to correct or 
change a routine. Then, the deck containing the 
modified routine can be extracted from the program 


library and used as if it had been entered into the 
system as a punched deck. 

A deck can be composed of punched cards or images 
of punched cards. Update makes no assumptions about 
contents. While programs are the usual contents 
maintained by Update, this utility is equally 
applicable to a set of data cards or any other text. 

The programmer controls Update operations through 
the following two mechanisms: 

• The UPDATE control statement parameters specify 
the general operations to be performed. The 
file parameters control the files to be manip¬ 
ulated and influence the type of operations 
performed. 

• The input stream directives specify the detailed 
operations to be performed and specify the line 
images to be made a part of the program library. 
The instructions for Update operation are called 
directives; the line images for the program 
library are called text. The input stream can 
be either part of the job deck containing the 
UPDATE control statement or a separate file. 


FILE NAMES 

Files used or generated by Update have generic 
names that are related to their default logical 
file names. The following names are used in the 
remainder of this manual in describing Update 
operations: 

o Input file - the user-supplied file or part of 
the job deck that contains the input stream of 
Update directives and text. 

« Output file - the listing file generated by 

Update that contains the status information 
produced during Update execution. It is in a 
format suitable for printing. 

• Program library - the file generated by an 

Update creation run that contains the decks of 
line images. When the file is created, it is 
known as the new program library. When the 
file is corrected, it is known as the old 
program library. Line images in the program 
library are in a format that can be manipulated 
by Update, but the format is meaningless to 

most other formats and utilities. 

• Compile file - Che file generated by Update 

that contains line images restored to a format 
that is acceptable to a compiler or assembler. 
Decks written to the compile file during any 
given run are controlled by the Update mode 
selected, by control statement parameters, and 
by directives in the input stream. 

• Source file - the file generated by Update that 
contains line images of an input stream that 
allows regeneration of the program library. 
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® Merge file “ the file that contains a program 
library that Update merges with the old program 
library to create a new program library. 

• Pullmod file - the file that contains 
directives and text of recreated correction 
sets. 

Section 2 contains a detailed discussion of the 
files used or generated by Update. 


DIRECTIVES 

The directives for Update are interspersed with 
text in the input stream. They are distinguished 
by the presence of a control character contiguous 
with a directive keyword. More than 40 directives 
exist. The directives can be grouped according to 
the following operations: 

» Identify decks. 

9 Control compile file contents. 

a Manipulate primary or secondary input streams, 

• Control overall handling of input files. 

• Modify program library contents. 

Section 3 contains a detailed discussion of Update 
directives. 


CREATION RUN 

A creation run constructs a program library. It is 
the original transfer of punched cards or line 
images into Update format. The input file of a 
creation run can consist of ASCII 8/12 or display 
code characters. ASCII characters must be 
right-justified in 12-bit bytes. The new program 
library is created in ASCII, if the input file uses 
ASCII and if the N or N8 parameter is specified on 
the UPDATE control statement. 


A creation run exists when the first line read from 
the input stream is a DECK or COMDECK directive. A 
creation run also exists when one or more of the 
following ten directives precedes the first DECK or 
COMDECK directive: 

ABBREV NOABBREV REWIND 

DECLARE NOLIST SKIP 

LIMIT READ /(comment) 

LIST 

The presence of any other directive before the 
first DECK or COMDECK directive causes Update to 
consider the run to be a correction run. 

In addition to the preceding directives, the 
following are the only Update directives that can 
be used during a creation runt 

CALL ENDTEXT TEXT WIDTH 

CWEOR ENDIF IF WEOR 

Each DECK or COMDECK directive defines a deck to be 
inserted into the program library that is being 
created. All text and directives following a DECK 
or COMDECK directive, until the next DECK or 


CCMDECK directive, are considered to be part of the 
deck. Each line image receives the deck name and a 
unique sequence number so that the images can be 
referenced individually. The DECK or COMDECK 
directive defining the deck itself is assigned the 
sequence number one• 

Update decks can be one of two types: a regular 

deck declared with a DECK directive, or a common 
deck declared with a COMDECK directive. DECK and 
COMDECK differ in that a common deck can be called 
by name so that it is inserted into the text of 
another deck when the compile file is being 
generated. One copy of the common deck exists on 
storage, but multiple copies can be part of a 

compile file. 

When the library is created, Update generates a 
deck named YANK$$$ as the first deck on the 
library. The YANK$$$ deck contains all the YANK, 
SELYANK, YANKDECK and DEFINE directives that are 
encountered during Update runs. (The YANK$$$ deck 
is described further in appendix D, File Format and 
Structure.) Update also generates a deck list and 
directory during a creation run. The deck list 

contains the names of all decks in the library and 
the location of the first word for each deck 

(random library) or the relative order of the decks 
(sequential library). The directory contains one 
entry for each DECK, COIDECK, and IDENT directive 
that is used for the library. 

CORRECTION RUN 

A correction run, which is the most common use of 
Update, introduces changes into the existing 
program library. These changes exist only for the 
duration of the run unless a new program library is 
generated. Update recognizes a correction run when 
it encounters a directive other than one of the ten 
creation run directives prior to encountering DECK 
or COMDECK. 

A correction run consists of a read-input-stream 
phase and a correction phase. During the first 
phase, Update reads directives and text, adds any 
new decks, and constructs a table of requested 
correction operations. During the second phase, 
Update performs the requested modifications on a 
deck-by-deck basis. 

The order in which a correction run is processed is 
not always the same as specified. During a 
correction run using a RESTORE directive and then a 
DELETE directive on the same line image or deck, 
the DELETE directive is processed first. If the 
PURDECK directive is used, it is also processed 
first, assuming that one UPDATE directive is used. 

The input file of a correction run can be in ASCII 
8/12 or display code characters. Update uses ASCII 
for the program library, if the character set of 
the old program library uses ASCII and the N or N8 
parameter is on the UPDATE control statement. 

The corrections to the library (the newly inserted 
lines, replaced lines, and deleted lines) make up 
the correction sets. The IDENT directive assigns a 
unique identifier to each line image inserted by 
the correction directives. Each inserted line 
image is assigned a sequence number beginning with 
one for each IDENT name. All line images having 
the same correction set identifier comprise a 
correction set. 
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Update permits a user to remove (yank) the effects 
of a correction set or deck and later restore the 
correction set or deck. This feature is convenient 
for testing new code. Requests for yanking are 
maintained in the YANK$$$ deck. Before obeying a 
correction, Update checks the correction identifier 
against the YANK$$$ deck to see if the correction 
has already been yanked. If the correction has 
been yanked, an informative message is issued and 
processing continues. This effect on the YANK$$$ 
deck can be selectively controlled through DO and 
DONT directives within the decks. 

The image of a line, even though deleted through 
DELETE or yanking, is maintained permanently on the 
program library with its current status (active or 
inactive) and a chronological history of 
modifications to its status. The images contain 
information known as correction history bytes. The 
history bytes that are generated by Update contain 
the history and s ta t us of the line and enable 
Update to reverse status. Deletion of a line, for 
example, is accomplished by the addition of a 
correction history byte to the line image rather 
than a physical deletion of the image. 
Consequently, the line can be reactivated at some 
later time. 

Update also allows a complete and irreversible 
purging of correction sets and decks. When a 
correction set or deck is purged, it is physically 
removed from the library. 


COPY RUN 

A copy run changes the old program library format 
from sequential to random or from random to 
sequential. Update recognizes a copy run when 
either the A or B parameter is specified on the 
UPDATE control statement. Since Update does not 
read the input file on a copy run, no other 
operations are performed. The control statements 
COPY, COPYBF, COPYCE, COPYBR, or COPYCR should not 
be used on random access files since the operating 
system might not recognize that the copied file is 
a random access file. 

DECK LIST AND DIRECTORY 
ORDER 

Update maintains a deck list and directory for its 
internal use. The deck list and directory are only 
significant to the user when ranges of decks or 
correction sets are specified on Update 
directives. The output file (0 parameter) lists 
the order of the deck names and correction set 
identifiers. The deck list and directory are 
always maintained in display code. 

The deck list contains a list of all decks in the 
program library. The original entries of the deck 
list correspond to the order of the decks when 
written during the creation run. Subsequent 
entries are added to the end of the list as they 
are introduced in the program library. Therefore, 
deck list order might not reflect actual deck order 
in the program library, since the user determines 
deck location within the program library through 
directives. 


The location of an entry in the deck list is 
significant in terms of parameters for PURDECK, 
SEQUENCE, and COMPILE directives in which a range 
of decks can be referenced. The order of names in 
a range reference must be the same as the order in 
the deck list. The decks named and all the decks 
between are then processed in accordance with the 
directive. An error exists if they are in reverse 
order. 

Similarly, as each deck and correction set is 
introduced into the program library, Update creates 
an entry in an internal directory in chronological 
sequence. The location of an entry in the 
directory is significant in terms of parameters for 
PURGE and YANK directives in - which a range of 
correction sets can be referenced. The order of 
reference must be the same as the order of the 
directory. The identified correction sets and all 
the sets between are processed in accordance with 
the directive. An error exists when a correction 
set range is not referenced in the order the sets 
were introduced into the library. 


UPDATE MODE 

The content of any compile file, source file, or 
new program library produced during a correction 
run is affected by the Update mode. (Table 2~2 in 
section 2 summarizes the effect of mode upon file 
content.) The mode of an Update run is determined 
by a combination of the omission or specification 
of the F and Q parameters on the Update control 
statement as summarized in table 1~1. 


TABLE 1-1. UPDATE MODE 


— 

Parameter 

Specified 

Mode 

F 

Full mode in which all decks 
on the old program library are 
processed. 

Q 

Quick mode in which only decks 
specified on COMPILE directives 
and decks added through ADDFILE 
directives are processed. 

F and Q 

Quick mode. 

F and Q 
omitted 

Normal selective mode in which 
the only decks processed are 
those modified or those specified 
on COMPILE directives. 


The mode chosen depends on how extensively the user 
wishes to modify the program library and its size. 
If the library contains many decks and the user 
wishes to modify only a few decks, quick mode 
should be used. If there are many decks and the 
user wants all decks to be processed, full mode 
should be used. Normal selective mode should be 
used when only those decks modified or specified 
are wanted in the compile file. 
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UPDATE FILES 
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During its execution, Update manipulates as many as 
eight files that can be referenced by the user. 
The files involved with any given run depend on the 
following: 

« The parameters selected by the UPDATE control 
statement. 

9 Whether the run is a creation run, correction 
run, or copy run. 

The files that Update generates or uses are 
described in this section. Each of these files has 
a default name, but other names can be specified 
through the appropriate parameters on the UPDATE 
control statement. 

File characteristics are summarized in table 2“1. 
The ASCII chracter set codes used in a file are 
8~bit characters, right-justified, in 12-bit bytes. 


Whether or not a file is optional, used, or not 
applicable on an Update run depends on the type of 
run, as follows; 


9 Creation run - the user must supply the input 
file. Update generates the new program 
library, compile file, and output file by 
default. The generation of a source file is 
optional. No other files are applicable on a 
creation run. 


9 Correction run - the user must supply the input 
file, the old program library, and the merge 
file (if a merge is to take place). Update 
generates, by default, the output and compile 
files. The creation of a new program library, 
source file, and pullmod file is optional on a 
correction run. 


TABLE 2-1. FILE SUMMARY 


File 

Default 

Name 

Contents 

Mode 

Default Position 

Input 

INPUT 

The input stream. 

Binary 

Remains at the end 
of the record (end- 
of-sec-tion for 

SCOPE 2) terminating 
Update directives. 

If Update aborts, 
location of input 
file is unpredict¬ 
able . 

New program library 

NEWPL 

Updated library. 

Binary 

Rewound before and 
after run. 

Old program library 

OLDPL 

Library to be updated. 

Binary 

Rewound before and 
after run. 

Secondary old 
program library 

None 

Library from which common decks 
can be called. 

Binary 

Rewinding not 
necessary because 
file must be 
random. 

Compile 

COMPILE 

Line images for assembly or 
compilation. 

Binary 

Rewound before and 
after run. 

Output 

OUTPUT 

Information for the programmer. 

Binary 

Remains in current 
position. File is 
not rewound. 

Source 

SOURCE 

Line images for regeneration of 
a new program library. 

Binary 

Rewound before and 
after run. 

Merge 

MERGE 

Second library to be merged 
into new program library. 

Binary 

Rewound before and 
after run. 

Pullmod 

Source 

file 

Re-created correction sets. 

Binary 

Rewound before and 
after run. 
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® Copy run - the iiser must supply the old program 
library. Update generates, by default, the new 
program library and the output listing file. 
No other files are applicable on a copy run 
and, if specified, are ignored. 

The contents of any compile file, source file, or 
new program library produced during a run are 
affected by the Update mode and the file format of 
the old program library. The contents of these 
files are summarized in table 2~2. 


INPUT FILE 

The input file contains the input stream; it must 
contain coded lines or their equivalent. The input 
stream consists of directives that direct Update 
processing and text to be added to the program 
library. The directives allowed in the input 
stream are determined by the type of Update run. 
The input data can be equal to or less than 256 
characters. 

Update initially reads the input stream from the 
primary input file specified by the I parameter of 
the UPDATE control statement; default file name is 
INPUT. Update stops reading directives and text 
when it encounters a 7/8/9 card or its equivalent, 
or end-of-information (EOI). 

If Update encounters a READ or ADDFILE directive in 
the input stream, it stops reading from the primary 
input file and starts reading from the file 
specified on the directive. Update reads one 


system-logical record (one section for SCOPE 2) 
from the secondary input file, then resumes reading 
from the primary input file. 

The input file can only consist of ASCII 8/12 or 
display code characters during a creation or 
correction run. No attempt to input ASCII 6/12 
data (on NOS) should be made. The ASCII 6/12 data 
must first be converted to ASCII 8/12 data using 
the NOS FCOPY control statement. Update uses ASCII 
8/12 for the program library if the character set 
of the old program library uses ASCII 8/12 and if 
the N8 parameter is on the UPDATE control 
statement. The input file character set is 
determined from the first line of the input file. 
If other than ASCII 8/12 character set data is 
entered, the invalid code is translated into a 
blank. See appendix A for the character set tables. 


PROGRAM LIBRARY FILES 

A program library is created during an Update run 
and can be manipulated in later runs. The library 
consists of a file of line images and internal 
information in a special format that can be 
processed only by Update. The line images are 
grouped into decks. Each line image is represented 
in a compressed format with multiple space 
characters removed that adds a line identifier. 
The format also includes history and status 
information that is known as correction history 
bytes. Program libraries can be maintained in 
display code or ASCII code characters. 


TABLE 2-2. FILE CONTENTS AND UPDATE MODE 


File 

Normal Selective Mode 
Contents 

Full Mode 

Contents 

Quick Mode Contents 
(Sequential OLDPL) 

Quick Mode Contents 
(Random OLDPL) 

New 

Program 

Library 

Regular decks and 
common decks after 
corrections are made. 

Regular decks and 
common decks after 
corrections are made. 

All decks specified 
on COMPILE directives, 
any common decks they 
call, and any common 
decks encountered 
prior to all decks of 
COMPILE. 

Decks specified on 
COMPILE directives 
and any common decks 
they call. 

Compile 

File 

Decks corrected or 
on COMPILE direc¬ 
tives and decks 
calling a corrected 
common deck (unless 
the calling deck 
precedes the common 
deck or NOPROP is 
specified on 

COMDECK). 

Active decks on old 
program library. 

Decks on COMPILE 
directives and decks 
added via ADDFILE 
plus called common 
decks. 

■Decks on COMPILE 
directives and decks 
added via ADDFILE 
plus called common 
decks. 

Source 

File 

Active lines and 
decks required to 
re-create the 
the library. 

Active lines and 
decks required to 
re-create the 
library. 

Active lines from 
decks specified on 
COMPILE directives, 
any common decks 
they call, and any 
common decks encount¬ 
ered prior to all 
decks on COMPILE. 

Active lines from 
decks specified 
on COMPILE directives 
and any common decks 
they call. A common 
deck called by a 
deleted *CALL 
directive. 
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The program library also contains a deck list and a 
directory. The deck list contains the names of all 
decks in the library. In addition to deck names, 
the directory also contains the names of all 
correction sets. Unless changed by the E parameter 
of the UPDATE control statement, the names in both 
the deck list and the directory exist in- the order 
they were introduced. 

Update can create and maintain program library 
files in two distinct formats: random and 

sequential. (These formats are described in detail 
in appendix D.) A random program library can be 
processed substantially faster than a sequential 
program library; however it can exist only on disk 
and not on tape. 


NEW PROGRAM LIBRARY 

A new program library is initially generated on a 
creation run. It contains directives and text in 
an updatable format. File content is determined by 
the file format of the old program library and 
Update mode as shown in table 2-2. The new program 
library name is specified by the N parameter of the 
UPDATE control statement; the default file name is 
NEWPL, The new program library character set is 
the same as the character set used in the input 
file during the creation run. 


For subsequent correction runs, the previously 
generated new program library is identified as the 
old program library. A new program library that 
incorporates the changes made during the correction 
run is generated if requested. If the old program 
library is in display code, the correction run 
character set can be ASCII 8/12 or display code. 

A new program library can be in random or 
sequential format. In the absence of the W 
parameter on the UPDATE control statement, the 
format is determined by file residence and record 
type as shown in table 2-3. 


TABLE 2-3. NEW PROGRAM LIBRARY FORMAT 


A new program library can be written or appended to 
an existing permanent file according to the 
permission rules of NOS, NOS/BE, or SCOPE 2. 


OLD PROGRAM LIBRARY 

The old program library is the file that was 
generated as a new program library in a previous 
run. It contains a record of changes made since 
the program library was created. The old program 
library name is specified by the P parameter of the 
UPDATE control statement; the default file name is 
OLDPL. 

An old program library is required for a correction 
run since it is the program library to be updated. 
On a copy run, the old program library is not 
modified, but is copied to a sequential or random 
new program library. If an old program library is 
specified on a creation rvin, it is ignored. 

In addition to the old program library to be 
updated, up to seven additional (secondary) old 
program libraries can be specified by the P 
parameter of the UPDATE control statement. Decks 
on the old program library can call common decks 
from the old program library or from any of the 
other secondary program libraries. No Update 
directive other than CALL can be used to reference 
common decks on secondary old program libraries. 
Common decks on secondary old program libraries can 
call common decks that reside on any of the old 
program libraries. Program libraries are searched 
in the order specified to find the called conmon 
decks. The called common decks that reside on the 
secondary old program libraries are not added to a 
new program library. 

The secondary old program libraries must be random, 
have a unique name, and have the same master 
control character as the old program library. If 
these conditions are not met, a diagnostic message 
is issued. 

When creating a new program library on a creation 
run that contains calls to common decks that reside 
on secondary old program libraries, C=0 must be 
specified on the UPDATE control statement. 


Format 

NOS and NOS/BE 

SCOPE 2 

Random 

File is on mass 

File is on mass 


storage and W 

storage, record 


is not 

type is W un- 


selected, 

blocked, and W 
is not 
selected. 

Sequential 

File is on mag¬ 

File is staged 


netic tape or W 

or online 


is selected. 

tape; or is on 
mass storage as 
record type S 
or record type 

W blocked; or W 
is selected, or 

R specifies no 
rewind. 


COMPILE FILE 

The compile file contains copies of decks in the 
program library restored to a format that can be 
processed by a compiler or assembler. The decks 
written to the file are determined by Update mode 
and the file format of the old program library as 
shown in table 2-2. Through the WIDTH directive, 

the user can specify whether the text on the file 

is to have Update line identifiers on each line of 
text. 

Compile file name is specified by the C or K 
parameter of the UPDATE control statement; default 
file name is COMPILE. If' the K parameter is 

specified, then decks are written to the compile 
file in the order they appear on COMPILE 

directives. (Any decks not specified on COMPILE 
directives follow those specified.) If the C 
parameter is specified, then decks are written on 
the compile file in the order they appear in the 
deck list. 
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The user has control over the decks written to the 
compile file through the compile file directives. 
Common decks can be called conditionally or 

unconditionally according to compile file 
directives embedded in the program library decks. 

Additional control of compile file format is 

afforded the user through directives that cause a 
system-logical record (end-of-section for SCOPE 2) 
of the specified level to be written at the end of 
decks. The compile file directives can be in the 

original decks or can be inserted into the program 
library decks during correction runs. These 
directives are interpreted when the compile file is 
written; the directives themselves are not written 
on the compile file. 


LISTABLE OUTPUT FILE 

The listable output file is the print file 
containing information for use by the programmer. 
Content of the file is controlled by the L 
parameter of the UPDATE control statement with 
options that can select a listing of directives 
processed, errors, comments, and a list of line 
images in the program library. The locations of 
all CWEOR, WEOR, ENDIF, IF, and CALL directives are 
listed if a compile file is written. if L«0, all 
listable output is suppressed. Output file name is 
specified by the 0 parameter of the UPDATE control 
statement; default file name is OUTPUT. If the 
output file is connected to a terminal, the default 
is L=l. 

In quick mode only, Update produces an ordered 
printout of the deck list of the program library 
under the heading DECK LIST AS READ FROM OLDPL PLUS 
ADDED NEW DECKS. A quick mode dummy Update run (no 
decks added) produces a deck listing of the old 
program library. 

The output file always defaults to display code 
characters unless the 08 option is specified. 


SOURCE FILE 

The source file is an optional file generated 
during a correction or creation run. The source 
file consists of the line images of an input stream 
that allows generation of a new program library. 
Only currently active line images are in 
resequenced format during a subsequent creation 
run. Only active DECK, COMDECK, WEOR, CWEOR, 
WIDTH, GALL, TEXT, IF, ENDIF, and ENDTEXT 
directives, in addition to all active text, are 
part of the source file. The line images in the 
source file do not contain line identifiers. 

The source file name is specified by the S 
parameter of the UPDATE control statement; default 
file name is SOURCE, The content of the file is 
determined by the T parameter of the UPDATE control 
statement and by Update mode and the file format of 
the old program library as shown in table 2-2. The 
user is responsible for routing the source file to 
a punch or other output device. 


If either the S or S6 parameter is specified, the 
source file is written in display code. If the S8 
parameter is specified, it is written in ASCII 
8/12. The character set of the old program library 
has no effect on the S8 parameter. 


MERGE FILE 

The merge file contains a program library to be 
merged with the old program library into a new 
program library. Update adds the deck list and 
directory from the merge file to the deck list and 
directory on the old program library. Any names on 
the merge file that duplicate names on the 'old 
program library are modified to make them unique as 
follows: 

• The last character of the name is changed by 
adding 01 (modulo 55g) until all valid char¬ 
acters have been tried. 

• A character is appended to the name and the 
first step is repeated. Characters are 
appended until the name reaches nine characters. 

If no unique name can be generated by this method, 
the Update run is abnormally terminated. 
Directives that reference these changed names are 
modified to agree with the new name. All names 

that required modification are listed in the output 
file. 

Merge file name is specified by the M parameter of 
the UPDATE control statement; default name is 

MERGE. All Update functions that are valid in a 
correction run are valid with the merge parameter. 
Care should be exercised when including 
modifications in a merge run. Update might change 
a name to which correction lines have been 
applied. In this case, corrections can refer to 
the wrong deck or correction set. 

Decks from the merge file are added to the new 

program library after all decks from the old 
program library are added. This sequence of decks 
in the new program library can be altered by the 

MOVE directive if desired. 


PULLMOD FILE 

The pullmod file contains directives and text of 
recreated correction sets specified on PULLMOD 
directives. These re-created correction sets 
produce the same results as the original sets. 
This feature permits a user to take an earlier 
version of the library and apply selected 
correction sets. The file has the same format as 
an input file. 

File name is specified by the G parameter of the 
UPDATE control statement. If no file is specified, 
pulled modifications are written to the source file 
specified by the S or T parameter; if no source 
file is specified, the re-created correction sets 
are written to a file named SOURCE. 
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Directives allow the user to create program 
libraries- Directives also extensively control and 
direct the correction and modification process. 
Directives perform the following operations: 

9 Identify decks. 

9 Control compile file contents. 


9 Manipulate primary or secondary input streams. 
9 Control overall handling of the input file. 

9 Modify program library contents 

Each directive is summarized in table-3-1. 


TABLE 3-1. SUMMARY OF UPDATE DIRECTIVES 


Directive Keyword 
Abbreviation 

Directive Format 

Use 

none 

*ABBREV 

Resume checking for abbreviated directives. 

*AF 

*ADDFILE Ifn,name 

Read creation directives and text from 
named file and insert after specified deck 
or line. 


. *BEF0RE line 

Write subsequent text lines before line 
identified- 

*CA 

*CALL deck 

Write connnon deck to compile file. 

*CH 

*CHANGE oldid.newid, . . . ,oldid,newid 

Change correction set identifier. 

*CD 

*C0MDECK deck,NOPROP 

Define common deck and propagation 
parameter- 

*C 

*C0MPILE deckl,deck2, . . « ,deckn 

Write specified decks to compile file, 
source file, and new program library. 


★COMPILE deckl.deck2 

Write inclusive range of decks to compile 
file, source file, and new program library. 

*CY 

★COPY deck,line 

Copy and insert specified line from named 
deck. 


★COPY deck,linel,line2 

Copy and insert specified range of lines 
from named deck. 


★COPY deck,linel,line2,Ifn 

Copy specified range of lines from named 
deck to specified file. 

*CW 

★CWEOR level 

Conditionally write end-of-record (end-of- 
section for SCOPE 2) or end-of-file. 

*DK 

★DECK deck 

Define deck to be included in program 
library. 

*DC 

★DECLARE deck 

Restrict corrections to named deck. 

*DF 

★DEFINE name1,name2, . . . ,namen 

Define names to be tested by IF directive 
while compile file is being written. 

*D 

★DELETE line 

Deactivate specified line and optionally in¬ 
sert text in its place. 


★DELETE line1,line2 

Deactivate inclusive range of lines and 
optionally insert text in their place. 
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TABLE 3-1. SUMMARY OF UPDATE DIRECTIVES (Contd) 


Directive Keyword 
Abbreviation 

Directive Format 

Use 

none 

*D0 identl,ldent2, . . . ,identn 

Reactivate yanked lines in specified 
correction sets until a DONT is encountered- 

*DT 

*D0NT identl,ident2, • • . ,identn 

Terminate the DO for specified correction 
sets. 

*EI 

*ENDIF 

Indicate end of conditional text. 

*ET 

ENDTEXT 

End delimiter for sequence of lines 
identifying text. 

*ID 

*IDENT idname,B*num,K“ident,U*ident 

Define correction set, bias for seqnum, and 
whether specified correction sets must be 
known or unknown to process this set. 

none 

*IF type,name,num 

Write specified number of following lines to 
the compile file if name of type DECK, IDENT, 
or DEF is known- 


*IF -type,name,nnm 

Write specified number of following lines to 
the compile file if name of type DECK, IDENT, 
or DEF is unknown. 


*INSERT line 

Write subsequent text lines after line 
Identified. 

*LT 

*LIMIT n 

Limit listable output to n lines. 

*L 

*LIST 

Resume listing lines encountered in input 

St ream • 

*M 

*M0VE deckl,deck2 

Place deck! after deck2. 

*NA 

*N0ABBREV 

Do not check for abbreviated directives. 

*NL 

*N0LIST 

Disable list option 4. 

*PM 

*PULLM0D identl,ident2, . . . ,identn 

Re-create specified correction sets and 
write them to file specified by the G 
option. 

*PD 

★PURDECK deckl,deck2, . . . ,deckn 

Permanently remove specified decks from 
program library. 


*PURDECK deckl.deck2 

Permanently remove inclusive range of decks. 

*p 

*PURGE identl,ident2, . . . ,identn 

Permanently remove specified correction sets 
from program library. 


*PURGE identl.ident2 

Permanently remove inclusive range of 
correction sets. 


*PURGE ident,* 

Permanently remove specified correction set 
and all sets introduced after it. 

*RD 

*READ Ifn 

Read directives and text from specified file. 

*R 

*REST0RE line 

Reactivate specified line and optionally 
insert text after it. 


★RESTORE linel,line2 

Reactivate inclusive range of lines and 
optionally insert text after them. 

*RW 

★REWIND Ifn 

Reposition named file to beginning-of- 
information. 
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TABLE 3-i. SUMMARY OF UPDATE DIRECTIVES (Contd) 


Directive Keyword 
Abbreviation 

Directive Format 

Use 

*SP 

★SELPURGE deckl.ident1,deck2.ident 2, 

• . . ,deckn•identn 

Permanently remove all lines in specified 
deck that belong to specified correction set. 

★SY 

★SELYANK deckl.iden11,deck2.ident2, 

. • • jdeckn-identn 

Deactivate all lines in specified deck that 
belong to specified correction set. 

★S 

★SEQUENCE deckl,deck2, • . . ,deckn 

Resequence all active lines and purge all 
inactive lines in specified decks. 


★SEQUENCE deckl.deck2 

Resequence all active lines and purge all 
inactive lines in inclusive range of decks. 

★SK 

★SKIP lfn,n 

Reposition named file forward the specified 
number of logical records. 

*T 

★TEXT 

Beginning delimiter for sequence of lines 
identifying text. 

*W 

★WEOR level 

Write end-of-record or end-of-file according 
to specified level. 

*WI 

★WIDTH linelen,idlen 

Reset size of line image written to compile 
file- 

*Y 

★YANK identl,ident2, . . , ,identn 

Temporarily remove specified correction sets 
from program library. 


★YANK ident1.ident2 

Temporarily remove inclusive range of 
correction sets. 

★YD 

★YANKDECK deckl,deck2, . . . ,deckn 

Temporarily deactivate decks specified. 

none 

★/comment 

Copy text to listable output file. 


DIRECTIVE FORMAT 

The general format of Update directives is shown in 
figure 3-1. A directive must begin with the master 
control character in column one. Comments can be 
placed after the last parameter of the directive. 
The comment and final parameter must be separated 
by one or more blanks. Most directives have both a 
full keyword and an abbreviated keyword as shown in 
table 3-1; when the NOABBREV directive is in 
effect. Update does not recognize the abbreviated 
forms of directive names. Any line in the input 
stream that cannot be recognized as a directive is 
assumed to be text. 


The master control chracter is recorded in the 
program library. For a correction run, the master 
control character should match the character used 
when the program library was created. If the 
characters do not match, Update uses the character 
specified in the program library. 


Since Update scans all 256 columns when interpret¬ 
ing directives, comments or sequencing information 
from a previous run can be interpreted as the 
parameter list. Update interprets comments or 
sequencing information as the parameter list when a 
list is not specified on WEOR, CWEOR, DECLARE, or 


★keyword p-List 

★ Master control character that distin¬ 

guishes a directive from a text Line- 
Must appear in column 1- This char¬ 
acter can be changed through the ★ 
parameter of the UPDATE control 
statement- 

keyword Name of one of the Update directives 
or an abbreviation for a directive. 

No blanks can occur between the master 
control character and the keyword; a 
comma or blank terminates the keyword. 

p-list Parameters identifying decks, cards, 

lines, or files. Some directives have 
no parameters- Multiple blanks can 
appear between the keyword and param¬ 
eters- Parameters in the list are 
separated by commas; embedded blanks 
cannot appear in the List- A blank 
terminates the p-list. 

Notice that several parameters con¬ 
tain a period as part of a single 
parameter. 


Figure 3-1. General Update Directive Format 
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ADDFILE directives. To avoid this problem, a null 
parameter list should be specified on these 
directives in the following manner: 

*WEOR,, *DECLARE,, 

*CWEOR,, *ADDFILE,,, 

Specifying a null parameter field ensures that 
Update will use the default values as parameters 
rather than using the coinnents or sequencing 
information. Errors will occur if Update tries to 
use the comment or sequencing information as the 
directive parameter list. 

LINE IDENTIFIERS 

Each line image in a program library is uniquely 
identified by an identifier and a sequence number. 
The identifier is the name of the deck or 
correction set from which the line image 
originated; Update supplies the sequence number. 
Line identifiers assigned by Update are usually 
permanent; they can be changed only through the use 
of the SEQUENCE and CHANGE directives. 

Update recognizes one full form and two short forms 
of line identifiers. The full form line identi¬ 
fiers are shown in figure 3-2. The two short forms 
of line identifiers, which can be used on BEFORE, 
INSERT, DELETE, RESTORE, and COPY directives, are 
expanded. 


ident.seqnum 

ident. 1- through 9-character name of a correc¬ 
tion set or deck. A period terminates 
the identifier, 

seqnum Decimal ordinal (1 through 131071) 

representing the sequence number of the 
line within the correction set or deck. 
Any character other than 0 through 9 
terminates the sequence number. 


Figure 3-2. Full Form of Line Identification 

In the short form (shown in figure 3-3), idname is 
assumed to be the last explicitly named identifier 
given on a BEFORE, INSERT, DELETE, RESTORE, or COPY 
directive, whether or not it is a deck name. The 
dname is assumed to be the last explicitly named 
identifier given on a BEFORE, INSERT, DELETE, 
RESTORE, or COPY directive that is known to be a 
deck name. Both of these default identifiers are 
originally set to YANK$$$; therefore, the first 
directive using a line identifier must use the full 
form to reset the default. 


seqnum 

Expands to idname.seqnum where idname 
is a correction set identifier, whether 
or not it is also a deck name. 

.seqnum 

Expands to dname.seqnum where dname is 
a deck name. 


Figure 3-3. Expansion of Short Forms 
of Line Identification 


All deck names are also identifiers (but all 
identifiers are not deck names). Thus, if EXAMPLE 
is the deck name last used, and there is no 
subsequent explicit reference to a correction set 
identifier, then both ,281 and 281 expand to 
EXAMPLE.281 as the line identifier. If there is an 
explicit reference to a correction set identifier 
ABC after the explicit reference to the deck name, 
then 281 would expand to the line identifier 
ABC.281 while .281 would expand to EXAMPLE,281. 

Figure 3-4 shows the differences in identifier 
expansion depending on Che order of the dir¬ 
ectives . A is a deck name and B is a correction 
set identifier on an old program library. . ^ 


*ID C 
★INSERT A. 

2 





data 

line 





★INSERT B. 

1 





data 

line 





*D Z, 

3 

expands 

to 

★DELETE 

B.2,B.3 

*t> 4, 

-5 

expands 

to 

★DELETE 

B.4,A.5 

★D ,7, 

5 

expands 

to 

★DELETE 

A.7,B.5 

★D •9/ • 

10 

expands 

to 

★DELETE 

A.9,A.10 

whereas: 






★ID D 

★INSERT B. 

1 





data 

line 





★INSERT A. 

2 





data 

line 





★D 2, 

3 

expands 

to 

★DELETE 

A.2,A.3 

★D 4, 

.5 

expands 

to 

★DELETE 

A.4,A.5 

★D .7, 

5 

expands 

to 

★DELETE 

A.7,A.5 

★D .9/ • 

10 

expands 

to 

★DELETE 

A.9,A-10 


Figure 3-4. Examples of Line 
Identifier Expansion 


DECK IDENTIFYING 
DIRECTIVES 

Each deck to be placed on a program library must be 
introduced by a DECK or CCWDECK directive during a 
creation or correction run. When Update encounters 
one of these directives in the input stream prior 
to any correction directive, the run is considered 
to be a creation run. When Update encounters one 
of these directives while inserting new text lines, 
it terminates the insert and adds the decks to the 
program library following the line specified. 

When a deck is added through the use of a DECK or 
CCMDECK directive during a creation run or an 
ADDFILE directive during a correction run, 
termination of that deck occurs when Update 
encounters another DECK or COMDECK directive, or 
the end of a system-logical record. Lines within 
that deck are identified by the name of the deck or 
common deck to which the lines belong and are 
numerically sequenced beginning with 1 for the DECK 
or CCMDECK directive. When a deck is inserted 
during a correction run as if it were text (that 
is, through the use of an INSERT, DELETE, BEFORE, 
or RESTORE directive), the deck is terminated by 
any condition that normally terminates insertion. 
The contents of the deck, including the DECK or 
COMDECK line, are identified by the correction set 
name and are numerically sequenced as if they were 
normal insertion text. 
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Frequently, a DECK or COMDECK directive precedes 
each program or subprogram in a given program 
library. More than one subprogram, however, can be 
included in a deck, as is indicated in figure 3~5. 
Normally, tvro programs are grouped together if 
modification of one program requires reassembly of 
both programs. 


★DECK 

FIRST 

IDENT 

FIRST 


EN^’ 

IDENT 

SECOND 


END 


★COMDECK FDATA 

BLOCK DATA 

COfWON/J3/A(10) 

DATA A/3*0., 7^1.0/ 

END 


Figure 3-5. Example of Deck Structure 


location specified by a preceding INSERT, BEFORE, 
or RESTORE directive. Each common deck must have a 
unique name. The COMDECK directive itself is part 
of the program library and has a sequence number of 
one within the name established by the directive. 
The COMDECK directive format is shown in figure 3-7. 


★COMDECK 

deck,N0PR0P 

deck 

Name of deck. Must be 1 through 9 
characters. Any character in the CDC 
display code character set is allowed, 
except blank, period, comma, and colon. 
Must not duplicate the name of an 
existing deck. 

NOPROP 

Indicates that decks calling this 
common deck are not to be considered 
as modified when the common deck itself 
is modified; that is, the effects of 
common deck changes are not to be 
propagated during normal Update mode. 
Optional. 


Because DECK and COMDECK directives can be 
deactivated by DELETE, YANK, or SELYANK, line 
images belonging to one deck at the beginning of an 
Update run can belong to a different deck at the 
end of the run. When a DECK or COMDECK directive 
is deactivated, all line images in the deactivated 
deck become members of the preceding deck on the 
program library; they retain their original line 
identifiers. If there is no preceding deck, then 
they become part of the YANK$$$ deck. 


DECK DIRECTIVE 

The DECK directive establishes a deck in the 
program library. It is one of the two directives 
that establishes the existence of a creation run. 
The directive can also be used in any correction 
run to add a deck to the location indicated by a 
preceding INSERT, BEFORE, DELETE, or RESTORE 
directive. Each deck must have a unique name 
within the program library. The DECK directive 
itself is part of the program library and has a 
sequence number of one within the name established 
by the directive. DECK directive format is shown 
in figure 3-6. 


★DECK deck 

deck Name of deck. Must be 1 through 9 char¬ 
acters. Any character in the CDC display 
code character set is allowed, except 
blank, period, comma, and colon- Must 
not duplicate the name of any other deck 
in program Library. 


Figure 3-6. DECK Directive Format 


COMDECK DIRECTIVE 

The COMDECK directive establishes a common deck 
that can be called from other decks as they are 
being written to the compile file. It is one of 
the two directives that establishes the existence 
of a creation run. The directive can be used in 
any correction run to add a common deck to the 


Figure 3-7. COMDECK Directive Format 

The NOPROP parameter of the COMDECK directive 
determines whether a deck calling a corrected 
common deck is to be considered as having been 
corrected. If NOPROP is specified, only the common 
deck is considered to be corrected. On the other 
hand, if NOPROP is not specified, the common deck 
and the calling decks are considered to be 
corrected. 

A common deck should be placed before any of the 
decks that call it. If the common deck is placed 
after a deck that calls it. Update might not be 
able to find it. In addition, decks calling a 
corrected common deck are not written to the 
compile file if the calling deck precedes the 
common deck and the mode is normal selective. 

CORRECTION DIRECTIVES 

Correction directives control updating of the old 
program library. New text is assigned a unique 
line identifier based on the correction set 
identifier. The corrected program library is 
written on the new program library; the old program 
library is not actually changed. Correction 
directives are illegal on a creation run. 


ADDFILE DIRECTIVE 

The ADDFILE directive causes Update to add a file 
of decks to the new program library, ADDFILE 
differs from the READ directive in that the 
contents of the specified file are limited to those 
allowed on a creation run. Unless the specified 
file is the primary input file, the READ directive 
cannot appear in the added file. The first line 
image of the specified file must be a DECK or 
COMDECK directive. If the INPUT file is specified, 
the READ directive can be the first image; a DECK 
or COMDECK directive must then be Che first line 
image on the file specified by the READ directive. 
An ADDFILE directive cannot appear among directives 
read from the file specified by a READ directive. 
The ADDFILE directive format is shown in figure 
3-8. If only one parameter is specified, it is 
assumed to be Ifn. 
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CHANGE DIRECTIVE 


*ADDFILE Lfn,name 

Ifn Name of Local file from which decks are 
to be added. If Lfn is omitted, the 
default is the file specified by the I 
parameter of the Update control state¬ 
ment; the separators are still required. 

name Name of deck or identifier Line after 

which decks are to be placed on the pro¬ 
gram library. If omitted, the addition 
is made after the Last deck on the pro¬ 
gram library. 

If the name parameter is *, it refers to 
the ident that is known to be a deck name 
most recently mentioned on a BEFORE, 

COPY, DELETE, INSERT, or RESTORE direc¬ 
tive. If no such directive precedes the 
ADDFILE, the YANK$$$ deck is used. 


Figure 3-8. ADDFILE Directive Format 

When the specified file is not the primary input 
file, Update adds directives and text until the end 
of one system-logical record is encountered. 
Update then returns to the file specified by the I 
parameter of the UPDATE control statement and 
continues processing the primary input stream. The 
specified file must have the same character set as 
the primary input file. When the file specified on 
the ADDFILE directive is the primary input file, 
however, Update adds line images until a 
noncreation directive or the end of the 
system-logical record is encountered. 

Update does not reposition the file specified on 
the ADDFILE directive. Any repositioning must be 
requested by the SKIP or REWIND directive. 


BEFORE DIRECTIVE 

The BEFORE directive inserts text line Images and 
compile file directives in the program library 
before the specified line image. The line images 
inserted are placed immediately after the 
directive. Line images cannot be inserted into the 
YANK$$$ deck. The inserted line images receive 
line identifiers established by the correction set 
name of the preceding IDENT directive. The BEFORE 
directive format is shown in figure 3-9. 


^BEFORE line 

line Line identifier of Line before which the 
insertion is to be made. 


Figure 3-9. BEFORE Directive Format 

Unless a TEXT directive has been encountered. 
Update terminates an insertion when it encounters 
the next insertion directive or a PURGE, PURDECK, 
IDENT, SELPURGE, ADDFILE, or SEQUENCE directive. 
On the other hand, compile file directives are 
inserted as if they are text after Update checks 
for correct syntax. Update interprets all other 
directives without terminating insertion; however, 
the directives are not inserted into the deck. 


The CHANGE directive renames correction set 
identifiers. It cannot be used to change deck 
names. As a secondary effect, changing the name of 
the correction set invalidates any YANK or SELYANK 
directives that refer to the set by its previous 
name. Since a CHANGE directive goes into effect 
immediately, any subsequent references to the 
correction set must use the new name. The CHANGE 
directive need not b'e part of a correction set. 
CHANGE directive format is shown in figure 3-10. 


★CHANGE oldid,newid,...,oldid,newid 

oLdid Name of correction set to be changed. 

newid New correction set name. Must be 1 

through 9 characters. Any character in 
the CDC display code character set is 
allowed, except blank, period, comma, 
and colon. Must not duplicate the name 
of any other correction set in the pro¬ 
gram library. 


Figure 3-10. CHANGE Directive Format 

COPY DIRECTIVE 

The COPY directive copies active line images from a 
deck on the old program library and inserts the 
images into another deck as if they are text in an 
input stream, or the COPY directive copies active 
line images to a specified file. Since Update 
copies the line images into a deck before applying 
corrections to them, line images can be copied and 
original images can be modified in the same run. 
An attempt to copy line images introduced during 
the same Update run produces an informative 
message. The COPY directive format for copying 
line images to a deck on the program library is 
shown in figure 3-11. The COPY directive format 
for copying line images to a file is shown in 
figure 3-12. 


A. Copy specified line. 

★COPY deck,Line 

deck Name of deck on old program library 
that contains the line to be copied. 

line Line identifier of line to be copied. 

B. Copy range of lines. 

★COPY deck,Iine1,line2 

deck Name of deck on old program library 
that contains lines to be copied. 

linel. Line identifiers of first and Last 

lineZ lines in sequence of Lines to be 
copied. 


Figure 3-11. COPY Directive Format - 
Copy to Deck 
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★COPY deck,line1,line2,Lfn 

deck Name of deck on oLd program Library that 
contains Lines to be copied. 

Line1, Line identifiers of first and Last Lines 

Line2 in sequence of Lines to be copied. 

Lfn Name of fiLe onto which Lines are to be 
copied- The user is responsibLe for the 
disposition of this fiLe since it is not 
positioned either before or after the 
copy- The fiLe is written as a binary 
fi Le that contains 256*~coLumn Line images 
with one system-LogicaL record (Section 
for SC0PE2) for each COPY directive; 
sequencing information is not incLuded. 


Figure 3-12. COPY Directive Format - 
Copy to FiLe 

An INSERT, DELETE, BEFORE, or RESTORE directive 
must be in effect to use COPY for copying line 
images to a deck. In figure 3-13, example A, the 
use of the COPY directive is valid because a 
preceding INSERT directive has initiated inser¬ 
tion. Line images BDECK_4 through BDECK.8 are 
copied and inserted after the text lines. The 
copied line images are sequenced as part of 
correction set X, The input stream in figure 3-13, 
example B, is not valid because insertion is not in 
effect to indicate where to write the line image 
copies. 


A. 

Valid use of COPY 


★IDENT X 
★INSERT BLAP.11 
(text Lines) 

★COPY BDECK,BDECK.4,BDECK.8 

B. 

Invalid use of COPY, 


★IDENT X 

★COPY BDECK,BDECK.4,BDECK.8 


Figure 3-13. COPY Directive ExampLe 


Placement in the input stream of a COPY directive 
that copies line images to a file is not 
restricted; COPY can appear anywhere in the primary 
input stream. Copying line images to a file is 
illegal, however, when a secondary input stream is 
being read as a result of a READ directive. 


DELETE DIRECTtVE 

The DELETE directive deactivates a line image or a 
group of line images and optionally inserts text 
and directives after the deleted line images. The 
line images to be inserted are placed immediately 
after the directive. The inserted line images 
receive line identifiers established by the 
correction set name of the preceding IDENT 
directive. The DELETE directive format depends on 
whether line images to be deactivated are specified 
by line identifier or by a range of lines, as shown 
in figure 3-14, 


A. DeLete specified Line 
★DELETE Line 

Line Line identifier for singLe Line 
to be deLeted. 

B- DeLete range of Lines 

★DELETE Line1,Line2 

Line1, Line identifiers of first and 
Line2 Last Lines, in sequence of Lines 
to be deLeted. Line Line1 must 
appear before Line2 in the exist¬ 
ing Library. The' range can in- 
cLude Lines aLready in a deact¬ 
ivated state. 


Figure 3-14, DELETE Directive Format 

Unless a TEXT directive has been encountered, 
Update terminates an insertion when it encounters 
the next insertion directive or a PURGE, PURDECK, 
IDENT, SELPURGE, ADDFILE, or SEQUENCE directive. 
On the other hand, compile file directives are 
inserted as if they are text after Update checks 
for correct syntax. Update interprets all other 
directives without terminating insertion; however, 
the directives are not Inserted into the deck. 


IDENT DIRECTIVE 

The IDENT directive establishes the name for the 
set of corrections being made. Lines added in this 
correction set are sequenced within the name 
specified. All correction set names must be 
unique. If a new program library is not being 
generated, a correction set need not begin with an 
IDENT directive. In this case. Update uses the. 
default name of .NO, ID. for new text lines. The 
established correction set identifier remains in 
effect until Update encounters another IDENT 
directive or a PURGE, SELPURGE, PURDECK, ADDFILE, 
or SEQUENCE directive. IDENT directive format is 
shown in figure 3-15. 


★IDENT 

idname,B=num,K=ident,U=ident 

idname 

Name to be assigned to this correction 
set. Must be 1 through 9 characters! 

Any character in the CDC display code 
character set is allowed, except blank, 
period, comma, and colon. Must not 
duplicate the name of another cor¬ 
rection set or deck. This directive 
causes a new entry in the directory. 

B=num 

Bias to be added to sequence numbers 
within deck. Optional; 1 is default. 

K=ident 

Indicator that specified correction 
set name must exist in the directory 
of the library before corrections can 
be made. Optional. 

U=ident 

Indicator that specified correction 
set name must not exist in the direc¬ 
tory of the library. Optional. 


Figure 3-15, IDENT Directive Format 
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Chnitting idname causes a format error. If idname 
duplicates a name previously used, Update issues an 
error message. Both errors are nonfatal as long as 
no new program library is created in the same run. 

The B, K, and U parameters on the IDENT directive 
can appear in any order. If more than one B 

parameter is specified. Update uses the last one 
encountered. More than one K or U parameter can be 
specified; in this instance, all correction set 
names must be known or unknown as specified before 
the correction set is processed. (An identifier is 
known whether it is active or inactive; an 

identifier that has been yanked is still known. To 

become unknown, an identifier must be purged.) If 

the criteria of these parameters is not met. Update 
skips the correction set and resumes processing 
with the next IDENT, PURGE, SELPURGE, PURDECK, or 
ADDFILE directive. 

In the following example, the bias of 100 is added 
to all ZAP correction set line sequence numbers: 

*IDENT ZAP,B-100,K=ACE,U-NON,U-=ARF 

The first line image in correction set ZAP has a 
sequence number of 101, not 1. Update skips the 

correction set if ACE is unknown or either NON or 
ARF is known. 


INSERT DIRECTIVE 

The INSERT directive inserts text line images and 
compile file directives in the program library 
after the specified line image. The line images to 
be inserted are placed immediately after the 
directive. Line images cannot be inserted into the 
YANK$$$ deck. The inserted line images receive 
line identifiers established by the correction set 
name of the preceding IDENT directive. The range 
of line images cannot be used when inserting. This 
causes only the first line image to be processed. 
INSERT directive format is shown in figure 3-16. 


★INSERT line 

line Line identifier of line after which in¬ 
sertion is to be made. 


Figure 3-16. INSERT Directive Format 

Unless a TEXT directive has been encountered, 
Update terminates an insertion when it encounters 
the next insertion directive or a PURGE, PURDECK, 
IDENT, SELPURGE, ADDFILE, or SEQUENCE directive. 
On the other hand, compile file directives are 
inserted as if they are text after Update checks 
for correct syntax. Update interprets all other 
directives without terminating insertion; however, 
the directives are not inserted into the text. 


MOVE DIRECTIVE 

The MOVE directive enables the user to reorder 
decks while producing a new program library. The 
deck to be repositioned is moved from its position 


on the old program library and placed after the 
specified deck on the new program library. The 
'YANK$$$ deck cannot be moved. A MOVE referencing a 
deck introduced in the same Update run produces an 
informative message. This directive does not 
terminate insertion and need not be part of a 
correction set. MOVE directive format is shown in 
figure 3-17, 


★MOVE deckl^deckZ 

decki Deck name on old program Library to be 
moved. 

deckZ Deck name after which decki is to be’' 
placed on new program library. 


Figure 3-17. MOVE Directive Format 


PURDECK DIRECTIVE 

The PURDECK directive permanently removes a deck or 
group of decks from the program library. However, 
the YANK$$$ deck cannot be purged. Every line 
image in a deck is purged, regardless of the 
correction set that contains the line image. 
Purging, unlike yanking, cannot be rescinded. A 
PURDECK directive can appear anywhere in the input 
stream; its appearance terminates the current 
correction set. PURDECK directive format depends 
on whether decks to be purged are specified 
individually by deck name or by a range of deck 
names, as shown in figure 3-18. 


A, Purge decks 

listed 

*PURDECK deck1,deck2,...deckn 

deck 

Name of deck to be purged. 

Names can appear in any order. 

B. Purge range 

of decks 

*PURDECK decki.decks 

decki.deckZ 

Names of first and last decks^ 
inclusive^ to be purged. Names 
must appear in the relative 
order in which decks exist in 
the deck list. 


Figure 3-18. PURDECK Directive Format 

The name of a purged deck is removed from the deck 
list; it can be reused as a deck name. An entry 
for the purged deck remains in the directory, 
however, until removed through the use of the E 
parameter on the UPDATE control statement. The 
deck name can also be removed from the directory by 
resequencing the library, that is, by creating a 
source file in one Update run and then using the 
source file as input on a subsequent creation run. 
Until a deck name is removed from the directory, it 
cannot be used as a correction set identifier. 
(See the PURGE directive.) 
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PURGE DIRECTIVE 


The PURGE directive permanently removes a 
correction set or group of correction sets from the 
I program library. Every line in the correction set 
is purged, regardless of its status as active or 
inactive. Purging, unlike yanking, cannot be 
rescinded. A new program library written during 
the same run treats the purged correction set as if 
it had never existed. A PURGE directive can appear 
anywhere in the input stream; it terminates the 
current correction set. PURGE directive format, as 
shown in figure 3-19, depends on whether correction 
sets to be purged are specified individually by 
correction set name, by a range of correction set 
names, or by relative time of introduction into the 
program library. 


A« Purge Listed correction sets 

♦PURGE identi,ident2,.,.,identn 

ident Identifier of a correction 

set to be purged. Identi¬ 
fiers can appear in any 
order. 

B. Purge range of correction sets 

♦PURGE identi.identP 

identi.identZ Identifiers of first and Last 
correction sets^ inclusive, 
to be purged. Identifiers 
must appear in the reLative 
order in which the correction 
sets were introduced into the 
program Library; that is, 
they must appear in the order 
they exist in the directory, 

C. Purge Later correction sets 

♦PURGE ident,♦ 

ident Identifier of correction set 

to be purged aLong with aLL 
correction sets introduced 
after the specified correc¬ 
tion set. 

* Indicator that the program 

Library is to return to an 
earLier LeveL. Intervening 
PURGE directives and SEQUENCE 
directives prevent compLete 
return. 


Figure 3-19. PURGE DIRECTIVE Format 

If Update cannot locate a specified correction set, 
it issues an error message. Purged identifiers can 
be reused on subsequent correction sets provided 
they do not appear in the YANK.$$$ DECK as a YANK 
directive parameter- 

RESTORE DIRECTIVE 

The RESTORE directive reactivates a line image or a 
group of line images previously deactivated through 


a DELETE directive. Any text line images and | 
compile file directives immediately following the 
RESTORE directive are inserted after the last line | 
image identified on the directive. Any inserted 
line images receive line identifiers established by | 
the correction set name of the preceding IDENT 
directive. RESTORE directive format depends on 
whether line images to be reactivated are specified I 
by a line identifier or by a range of lines, as | 
shown in figure 3-20. 


A, Restore specified Line. 

♦RESTORE Line 

Line Line identifier of Line to be re¬ 
stored. 

B. Restore range of Lines. 

♦RESTORE Linel,Line2 

Linel, Line identifiers of first and Last 

Line2 Lines, incLusive, in sequence of 
Lines to be restored. Linel must 
appear before Line2 in the existing 
Library. Any Lines in the sequence 
that are aLready active are not 
affected. 


Figure 3-20. RESTORE Directive Format 

Unless a TEXT directive has been encountered, 
Update terminates an insertion when it encounters 
the next insertion directive or a PURGE, PURDECK, 
IDENT, SELPURGE, ADDFILE, or SEQUENCE directive. 
On the other hand, compile file directives are 
inserted as if they are text after Update checks 
for correct syntax. Update interprets all other 
directives. without terminating insertion; however, 
the directives are not inserted into the deck. 


SELPURGE DIRECTIVE 

The SELPURGE directive permanently removes the 
effects of the specified correction set on the 
specified deck. Only the line images belonging to | 
the specified correction set are purged from the 
specified deck. Line images belonging to the | 
specified correction set that are in other decks 
are not purged. Line images in the YANK$$$ deck | 
can be purged through SELPURGE. A SELPURGE 

directive can appear anywhere in the input stream; 
it terminates the current correction set. SELPURGE 
directive format is shown in figure 3-21. 


♦SELPURGE deckl-identi..,deckn.identn 

deck Name of deck from which correction set 
is to be removed. 

ident Name of correction set to which cards to 
be removed beLong. It must be separated 
from the deck by a period. 


Figure 3-21. SELPURGE Directive Format 
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SELYANK DIRECTIVE 

The SELYANK directive temporarily removes the 
effects of the specified correction set on the 
I specified deck. Only the line images belonging to 
the specified correction set are yanked from the 
I specified deck. Line images belonging to the 
specified correction set that are in other decks 
I are not yanked. Line images in the YANK$$$ deck 
can be yanked through SELYANK. A SELYANK directive 
must be part of a correction set; it is placed in 
the YANK$$$ deck. The SELYANK directive format is 
shown in figure 3~22. 


*SELYANK decki.identi..,deckn.identn 

deck Name of deck from which correction set 
is to be removed. 

I ident Name of correction set to which lines to 
be removed belong. It must be separated 
from deck by a period. 


Figure 3-22. SELYANK Directive Format 


SEQUENCE DIRECTIVE 

I The SEQUENCE directive resequences active lines and 
I purges inactive lines from the specified deck(s). 
Only those decks explicitly mentioned on the 
SEQUENCE directive are resequenced. Thus, if a 
correction set (for example, SETl) affects more 
than one deck on a program library (for example, 
DECKI and DECK2), and only DECKI has been 
subsequently resequenced through SEQUENCE, the 

I SEQUENCE directive does not affect SETl lines 
within DECK2- The YANK$$$ deck cannot be 
resequenced. SEQUENCE directive format, as shown 

in figure 3-23, depends on whether decks to be 
resequenced are specified individually by name or 
are specified as a range of deck names. 


A- Resequence listed decks. 

★SEQUENCE decki,deck2,-..,deckn 
deck Name of deck to be resequenced. 

B- Resequence range of decks. 

★SEQUENCE decki.deck2 

decki.deck2 Name of first and last decks, 

inclusive, to be resequenced. 
Decki must appear before deck2 
in old program library. 


Figure 3-23. SEQUENCE Directive Format 

Update normally allows deck and correction sets 
having the same name to coexist on the old program 
library. If a deck having the same name as a 
I correction set is resequenced and lines for the 
correction set are in other decks, Update purges 
any modifications made by that correction set 
outside the resequenced deck to prevent duplicate 
identifiers. 


The SEQUENCE directive does not result in 
identifiers being deleted from the directory even 
if, as a result of resequencing, no references to 
an identifier are on the. library. This situation 
arises when all the corrections of a correction set 
refer to a deck that is resequenced. Deletion of 
the identifier, in this case, requires an edit 
(E parameter) or PURGE in a subsequent Update run. 

A deck cannot be renamed and resequenced in the 
same Update run. (To rename a deck, delete the 
first line of the deck and replace it with a new | 
DECK directive containing the new name.) 


YANK DIRECTIVE 

The YANK directive temporarily removes a correction 
set or group of correction sets from the program 
library. Line images activated by the correction 
set are deactivated; line images deactivated by the 
correction set are reactivated. If a correction 
set has been yanked, it is ignored during compile 
file or source file generation- The effects of the 
YANK directive can be selectively nullified through 
the introduction of DO and DONT directives in the 
decks. Update places the YANK directive in the 
YANK$$$ deck. The YANK directive format, as shown 
in figure 3-24, depends on whether correction sets 
to be yanked are specified individually by 
correction set name or by a range of correction set 
names. 


A. Yank listed correction sets 

★YANK identi,ident2,..-,identn 

ident Identifier of a correction 

set to be yanked. Identi¬ 
fiers can appear in any 
order. 

B. Yank range of correction sets 
★YANK ident1.ident2 

identi.ident2 Identifiers of first and Last 
correction sets, inclusive, 
to be yanked. Identifiers 
must appear in the relative 
order in which the correction 
sets were' introduced into the 
program Library; that is, 
they must appear in the order 
they exist in the directory. 


Figure 3-24. YANK Directive Format 

The YANK directive differs from PURGE in several 
respects: YANK must be part of a correction set; 

YANK does not terminate the current correction set; 
and the effects of a YANK directive can be 
rescinded. 

YANKDECK DIRECTIVE 

The YANKDECK directive temporarily removes all 
lines within the decks specified. All lines are | 
deactivated, even if they belong to a correction 
set. YANKDECK differs from PURDECK in several 
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respects; YANKDECK must be part of a correction 
set; it does not terminate the current correction 
set; and its effects can be rescinded. The 
YANKDECK directive format is shown in figure 3-25. 


*YANKDECK decki,deck2,...,deckn 

deck Name of deck to be yanked. Names can 
appear in any order. 


Figure 3-25. YANKDECK Directive Format 

The deck YANK$$$ cannot be deactivated as a whole. 
Individual YANK directives within this deck can be 
yanked by a YANK directive, however. 

COMPILE FILE DIRECTIVES 

Compile file directives provide control over the 
compile file. These directives are interpreted 
when the program library decks are being corrected 
and written onto the compile file. Calls for 
common decks result in the common deck being 
written on the compile file. Other directives 
allow control of file format. None of the compile 
file directives are written on the compile file. 

The user can prepare the original deck with 
embedded compile file directives (except for DO or 
DONT) or the user can insert compile file 
directives into program library decks as a part of 
a correction set. Compile file directives are not 
processed when they are encountered in the input 
stream (except for COMPILE); they are simply 
considered as text lines to be inserted and 
sequenced accordingly after update checks for 
correct syntax. To be recognized while the compile 
file is being written, these directives must have 
the same master control character as defined when 
the library was created. 


CALL DIRECTIVE 

The CALL directive causes the active text of a 
common deck to be written onto the compile file. 
The directive itself is stored as part of a deck 
and can be referenced by its line identifier. CALL 
is effective only within a deck or common deck. 
Common decks can call other common decks, but a 
common deck must not either call itself or call a 
common deck that contains a call to the common 
deck. Neither the CALL directive nor the COMDECK 
directive vAiich defined the deck is written to the 
compile file. The CALL directive format is shown 
in figure 3-26. 


★CALL deck 

deck Name of an existing common deck to be 
written to the compile file. 


Figure 3-26. CALL Directive Format 

Common decks can also be called from secondary old 
program libraries. If COMDECK names are duplicated 
on any secondary old program libraries, Update uses 


the first COMDECK encountered according to the 
order of the secondary old program libraries as 
specified by the P parameter of the UPDATE control 
statement. 


COMPILE DIRECTIVE 

The COMPILE directive indicates which decks are 
written to the compile file. During normal mode, 
decks specified on COMPILE directives and corrected 
decks are written to the compile file. During 
quick mode, decks specified on COMPILE directives 
and any common decks called by the directives are 
written to the compile file. The directive is 
ignored during a full Update. 

The directive also affects the contents of any new 
program., library and source file as shown in 
table 2-2 in section 2. The COMPILE directive 
format, as shown in figure 3-27, depends on whether 
decks to be written are specified individually by 
name or are specified as a range of deck names. 


A. Compile listed decks 

★COMPILE deck1,deck2,...,deckn 

deck Name of deck to be written to 

the compile file, new program 
library file, and source file. 

B. Compile range of decks 
★COMPILE deck1.deck2 

deck1.deck2 Names of first and last decks 
in range, inclusive, to be 
written to the compile file. 
The name of decki must appear 
before the name of deck2 in 
the old program library deck 

li St. 


Figure 3-27. COMPILE Directive Format 

Decks are written to the compile file in the order 
that the decks exist on the old program library, 

unless the K option is selected on the UPDATE 
control statement. If the K option has been 
specified, the decks are written in the order they 
appear on the COMPILE directive. 

When a deck is being introduced in the same run 

that contains a COMPILE directive for the deck, the 

DECK directive must appear before the COMPILE 

directive. Otherwise, COMPILE directives can be 
anywhere in the input stream. They do not affect 
the current correction set name. 


CWEOR DIRECTIVE 

The CWEOR directive writes an end of system-logical 
record (section for SCOPE 2) on the compile file if 
data has been written to the file since the start 
of UPDATE or since the last end of system-logical 
record was written. The CWEOR directive format is 
shown in figure 3-28. 
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*CUE0R 

level 




level 

Level of 

system- 

logical record. 


For SCOPE 

2, the 

following: 


RT=W 

0 thru 

14 

end-of-section 


RT=W 

15 


end-of-partition 


RT=S 

0 thru 

15 

end-of-record 


RT=Z 

0 thru 

15 

end-of-section 


BT=C 

0 thru 

15 

end-of-section 


Figure 3-28. CWEOR Directive Format 


DO DIRECTIVE 

The DO directive causes Update to rescind a yank of 
specified correction sets while writing text to the 
compile file* If a line was deactivated as a 
result of a YAJ^K or SELYANK, the line is 
reactivated. Likewise, if a line was activated by 
a YANK or SELYANK, Update deactivates it. A DO 
remains in effect until a DONT directive is 
encountered. The DO directive can be placed 
anywhere in the library. If Update encounters a DO 
for an unyanked correction set, an informative 
message is issued and the DO is ignored. The DO 
directive format is shown in figure 3-29, 


*D0 ident1,ident2,...,identn 

ident Name of correction set for which yanking 
is to be rescinded or initiated- 


Figure 3-29. DO Directive Format 


DONT DIRECTIVE 

The DONT directive terminates a DO directive. It 
can also be used to initiate a yank of an unyanked 
correction set. When Update encounters a DONT for 
a correction set that has not been yanked, it yanks 
the set until it encounters a DO directive for the 
set. If the correction set has already been 
yanked, Update issues an informative message and 
ignores the DONT. The DONT directive can be placed 
anywhere in the program library. The DONT 
directive format is shown in figure 3-30. 


*D0NT ident1,ident2/--.,identn 

ident Name of correction set for which yanking 
is to be rescinded or initiated- 


directive• Since num takes precedence, the END IF 
directive is included in the count of active lines 
and is written on the compile file. The ENDIF 
directive format is shown in figure 3-31. 


*ENDIF 


Figure 3-31. ENDIF Directive Format 


IF DIRECTIVE 

The IF directive conditionally writes text ‘on the 
compile file- When Update encounters an IF 
directive, the text following the directive is 
written or skipped depending on the condition. The 
IF directive format, as shown in figure 3-32, 
depends on whether the specified name is to be 
known or unknown for the text to be written on the 
compile file. 


A. Name must be known (on old program library). 
*IF type,name,num 

B. Name must be unknown (not on old program 
library). 

*IF -type,name,num 

type Type of condition name. 

DECK Name is deck name. To be 

known, it must be in the deck 
list on the primary old pro¬ 
gram Library. 

IDENT Name is correction set iden¬ 
tifier. To be known, it must 
be in the directory on the 
primary old program library. 

DEF Name is defined through 

DEFINE directive on the old 
program library. 

When type is not preceded by a minus 
sign, the name must be known for text 
to be written. When type is preceded 
by a minus sign, the name must not be 
known for text to be written- 

name Deck name, correction set identifier, 
or defined name, according to type. 

num Number of active line images to be 
skipped if condition is not met. 
Optional. 


Figure 3-30. DONT Directive Format 


Figure 3-32. IF Directive Format 


ENDIF DIRECTIVE 

The ENDIF directive indicates the end of 
conditional text. It is used with IF when the num 
parameter is omitted from the IF directive. ENDIF 
should not be used if num is specified on the IF 


If the num parameter is omitted and the condition 
is not met. Update searches for an ENDIF directive 
and resumes processing of the deck at that point; 
if ENDIF is not found, then the remainder of the PL 
is skipped and the compile file stops at this 
point; no error message is written. When the 
condition is met, no lines are skipped. 
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When an IF directive is encountered on a secondary 
old program library, Update only searches the 
directory, deck list, and YANK$$$ deck on the 
primary old program library in trying to satisfy 
the conditional. The deck lists, directories, and 
YANK$$$ decks of the secondary old program 
libraries are not searched. 

When both an IF directive is encountered as a 
result of a CALL and a matching ENDIF directive is 
found as the result of a second CAXX, the range of 
the IF, ENDIF pair is unpredictable. 

WEOR DIRECTIVE 

The WEOR directive causes the termination of the 
current system-logical record on the compile file 
with the specified level. The WEOR directive 
format is shown in figure 3-33. 


*WE0R 

level 




level 

Level of 

system- 

logical record. 


For SCOPE 

2, the 

following: 


RT-W 

0 thru 

14 

end-of-section 


RT=W 

15 


end-of-pa rtition 


RT=S 

0 thru 

15 

end-of-record 


RT=Z 

0 thru 

15 

end-of-section 


BT=C 

0 thru 

17 

end-of-section 


Figure 3-33. WEOR Directive Format 


WIDTH DIRECTIVE 

The WIDTH directive overrides the default compile 
file line image width settings, as specified by D 



Figure 3-35. Fields of Line Image | 

and Identification 


If *WIDTH is specified with no parameters, the run 
default settings are restored. If only the length 
of the Identification field is specified (*WIDTH 
jidlen), then linelen is the previous setting 
used. If only linelen is specified (*WIDTH 
linelen), the previous setting of idlen is used. 

FILE MANIPULATION 
DIRECTIVES 

File manipulation directives control secondary 
input files during Update processing. These 
directives can only appear in the primary input 
stream. They are illegal on a secondary input file. 


READ DIRECTIVE 

The READ directive temporarily stops reading the 
primary input stream and begins reading an input 
stream from the specified file. READ differs from 
ADDFIIE in that the content of the file specified 
by READ is not restricted except to prohibit the 
appearance of another READ directive or the 
ADDFILE, SKIP, and REWIND directives. Update reads 
from the specified file one system-logical record 
(section for SCOPE 2). Processing then continues 
with the main input stream. The READ directive 
format is shown in figure 3-36. 


and/or 8 on the UPDATE control statement. WIDTH 
directives are ignored with compressed compile 
files. The format for the WIDTH directive is shown 
in figure 3-34. 


stream. 


Figure 3-36. READ Directive Format 

The specified file cannot be one of the reserved 
files specified by a parameter on the UPDATE 
control statement. It can only be a local 
secondary input file. Also, the specified file 
must have the same character set as the primary 




Figure 3-34. WIDTH Directive Format 


input file. 


The sum of the length of linelen and idlen must be 
equal to or less than 256 characters. If idlen is 
set to 0 (zero), the identification field is 
suppressed. The format of the fields linelen and 
idlen are shown in figure 3-35. The sequence data 
(S) is positioned within the identifier name field 
(I) by the following procedure: 

1. Blanking the field. 

2. Putting in the identifier name, left-justified 
with truncation on the right as needed. 

3. Placing the sequence number over the field, 
right-justified with truncation on the left as 
needed. 


REWIND DIRECTIVE 

The REWIND directive repositions the specified file 
to beginning-of-informat ion. The file to be 
rewound cannot be one of the reserved files. It 
can only be a secondary input file. The REWIND 
directive format is shown in figure 3-37. 



Figure 3-37. REWIND Directive Format 
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SKIP DIRECTIVE 


The SKIP directive repositions the named local file 
forward one or more system-logical records. A 
system-logical record (section for SCOPE 2) of 
level 178 end-of-inf ormation terminates skip¬ 

ping. The SKIP directive format is shown in 
figure 3-38. 


★SKIP Ifn^n 

Ifn Name of file to be positioned. 

n Number of Logical records (sections for 
SCOPE 2) to be skipped in the forward 
direction. If n is omitted. Update skips 
one record (section). 


Figure 3-38. SKIP Directive Format 


INPUT STREAM CONTROL 
DIRECTIVES 

The input stream control directives allow the user 
to specify whether or not Update is to recognize 
abbreviated directives, delimit text, or control 
I which input stream lines are to be displayed on the 
listing file. 


ABBREV DIRECTIVE 

The ABBREV directive causes checking for 
abbreviated directives to be resumed. It is used 
in connection with the NOABBREV directive. The 
ABBREV directive format is shown in figure 3-39. 


★ABBREV 


Figure 3-39, ABBREV Directive Format 


ENDTEXT DIRECTIVE 

The ENDTE5CT directive ends the condition 
established by a prior text directive. If ENDTEXT 
is encountered before TEXT, Update ignores it. The 
ENDTEXT directive format is shown in figure 3-AO. 
Any information in columns 10 through 256 is taken 
as a comment. 


★ENDTEXT 


Figure 3-40. ENDTEXT Directive Format 


LIST DIRECTIVE 

I The LIST directive causes listing of lines in the 
input stream to be resumed. It is used in 
connection with NOLIST. The LIST directive format 
is shown in figure 3-41. 


♦LIST 


Figure 3-41, LIST Directive Format 


NOABBREV DIRECTIVE 

The NOABBREV directive causes Update to stop 
checking for the abbreviated forms of the 
directives. Update expands the name when it reads 
an abbreviated form so that it is a full name. The 
user has the option of not using abbreviations and 
of turning off the check through the NOABBREV 
feature. In this mode, an abbreviated directive is 
not recognized but is taken as text. The NOABBREV 
directive format is shown in figure 3-42. 


★NOABBREV 


Figure 3-42, NOABBREV Directive Format 

NOLIST DIRECTIVE 

The NOLIST directive disables list option 4. 
Update stops listing lines in the input stream when 
it encounters a NOLIST and resumes listing lines 
when it encounters a LIST. NOLIST directive format 
is shown in figure 3-43, 


★NOLIST 


Figure 3-43. NOLIST Directive Format 

LIST and NOLIST can occur anywhere in the input 
stream. They do not terminate insertion or a 
correction set. The LIST/NOLIST directives are 
Ignored if list option 0 is selected. 


TEXT DIRECTIVE 

The TEXT directive, used in connection with 
ENDTEXT, causes all following line Images to be | 

treated as text, whether or not they begin with the 

master control character and would otherwise be 

considered as directives. When Update encounters a 
TEXT directive, the TEXT directive line image and I 
all line images following it, up to and including | 
the ENDTEXT directive, are considered as text and 
are written on the program library. A TEXT 
directive in the input stream must be either in a 
deck or in text being inserted. The TEXT and 
ENDTEXT directives are maintained on the program 
library as text line images; however, they are not | 
written on the compile file. The TEXT format is 

shown in figure 3-44. Any information in columns 
10 through 256 is taken as a comment. 


★TEXT 


Figure 3-44, TEXT Directive Format 
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SPECIAL DIRECTIVES 

The special directives provide extended features. 
With the exception of DEFINE and PULLMOD, they can 
appear any place in the input stream for creation 
or correction runs. 


DECLARE DIRECTIVE 

The DECLARE directive protects decks other than the 
declared deck from being inadvertently altered. 
Subsequent corrections are restricted to the named 
deck until Update encounters a DECLARE directive 
with no deck name or another DECLARE directive with 
a different deck name. This directive can only be 
used when the DECLKEY installation option has been 
assembled. The DECLARE directive format is shown 
in figure S-'AS. 


★DECLARE deck 

deck Name of deck to which following correc¬ 
tions are restricted. Omitting deck 
nullifies a previous DECLARE. 


Figure 3-45. DECLARE Directive Format 

When the DECLARE directive is encountered, the 

following restrictions go into effect: 

• PURGE and YANK directives are illegal. 

• INSERT, DELETE, RESTORE, and BEFORE directives 
can apply only to lines in the declared deck, 
if they do not, the operation is not performed 
and Update issues an informative message. 

0 Inserting or reactivating a DECK or COMDECK 
directive is illegal. 

New decks inserted via the ADDFILE directive need 

not be named in a DECLARE directive. 


DEFINE DIRECTIVE 

The DEFINE directive establishes a condition to be 
tested by the IF directive. The names on a DEFINE 
directive are unrelated to correction set 
identifiers or deck names. Update places DEFINE 
directives in the YANK$$$ deck. A DEFINE directive 
can be placed anywhere in a correction set. The 
DEFINE directive format is shown in figure 3-46. 


The END directive provides compatibility with Che 
SCOPE EDITSYM program. The END directive format is 
shown in figure 3-47, 


★END 


Figure 3-47, END Directive Format 


LIMIT DIRECTIVE 

The LIMIT directive changes the maximum size for 
the listable output file from the default value of 
6000 lines to the specified numb'er of lines. It 
should be one of the first lines encountered in the 
input stream. The LIMIT directive will not appear 
in the new program library. The LIMIT directive 
format is shown in figure 3-48. | 


★LIMIT n 

n New line limit for listable output. 


Figure 3-48. LIMIT Directive Format | 

When the specified limit is reached, options 3 
(line image, deck name, and modification key) and 4 
(input stream) are turned off. Errors and direc¬ 
tives are still listed, however, if options 1 and 2 
were selected. Options 5 through 9 are not 
affected. Refer to L parameter in section 4. 


PULLMOD DIRECTIVE 

The PULLMOD directive causes the program library to 
be searched for all line images belonging to each 
specified correction set and reconstructs a set of 
directives and text. The reconstructed correction 
set produces the same results as the original set. 
The search of the library is performed at the end 

of the Update run. Therefore, any modifications 
made by the current run are reflected in the 

PULUtOD results. Each reconstructed correction set 
is written to the file specified by the G parameter 
on the UPDATE control statement. All of the sets 
are contained within one system-logical record 

(section for SCOPE 2) on the file. The PULLMOD 

directive format is shown in figure 3-49. The | 
PULLMOD directive can be used only when the PMODKEY 
installation option has been assembled for Update. 


★DEFINE name1,name2,...,namen 




name Name for subsequent testing by IF 


★PULLMOD ident1,1dent2,...,identn 

directive. 


ident Name of correction set to be re-created- 


Figure 3-4<5. DEFINE Directive Format Figure 3-49. PULLMOD Directive Format I 


END DIRECTIVE 

The END directive is ignored in the input stream. 
Update does not copy it onto the old program 
library. 


The user is responsible for determining whether or 
not the reconstructed correction sets accurately 
reflect the original corrections, PULLMOD is 
unable to determine if line images have been purged 
subsequent to the addition of the correction sets 
requested. 
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A pullmod file has the same format as an input 
file. This feature permits a user to take an 
earlier version of the library and apply selected 
correction sets. 


/ COMMENT DIRECTIVE 

The / directive introduces a comment into the 
listable output file. Update ignores this line 
except to copy it to the listing file. A commant 


can appear at any place in the input stream. The 
slash can be redefined as another character through 
the / comment directive format as shown in figure 
3“50, The slash must appear in column 2. Column 3 
must be a comma or blank. 



Figure 3-50. Comment Directive Format 
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UPDATE CONTROL STATEMENT 


4 


The Update utility is called by the UPDATE control 
statement* Parameters specify options and files 
for the run. The format of the call is shown in 
figure 4-1, The word UPDATE must begin in column 
one. See the operating system reference manual for 
additional control statement syntax requirements. 


UPDATE(p-list) 

p-List Parameters specifying options- Param¬ 
eters in the List are separated by 
commas. A Left parenthesis or a comma 
must separate the List from the word 
UPDATE- A right parenthesis or a 
period terminates the statement- 


figure 4-1. UPDATE Control Statement Format 


PARAMETERS 

All update parameters are optional and can appear 
in any order. The parameters that specify files 
(C, G, I, K, M, N, 0, P, S, T) optionally can be 
followed with either the digit 6 or 8 , indicating 
6 -bit display code or 8 -bit ASCII. 

When using the C, G, K, 0, P> S, or T parameters, 
the digit 6 forces the character set of the file to 
be 6 -bit display code. The digit 8 forces the 
character set to be 8 -bit ASCII, For example, 
C 8 -FILE specifies that the decks are to be written 
to the compile file named FILE using the ASCII 
character set. The 6 and the 8 cannot both be 
specified at once for the same file. These 
parameters each have a default of either display 
code or ASCII, which can be overridden by using 
either the 6 or 8 digit (6 overrides an ASCII 
default and 8 overrides a display code default). 

When using the I parameter without the 6 or 8 
digit. Update will determine the correct character 
set to use. For the N or N 8 parameter, Update only 
uses ASCII if the old program library or input file 
has ASCII data. The N 8 parameter does not force 
ASCII automatically. When using the M and N 
parameters, the character set is determined from 
the library's internal header. 

By using the Update parameters, it is possible to 
convert a file of display code data to ASCII, or 
visa versa. This capability can be useful when 
your operating system does not have a standard 
utility to change the character set (such as 
SCOPE). The file to be converted must be in a 
legal input file format. An example of how a 
display code to ASCII conversion can be done is 
shown in the Update Control Statement Examples 
subsection, which appears at the end of this 
section. 


The Update parameters are summarized in table 4-1 
and are described in detail below. 


A SEQUENTIAL-TO-RANDOM COPY 

This parameter copies a sequential old program 
library to a random new program library. No other 
Update operations are performed; any I parameter is 
ignored. The only other control statement 
parameters that can be used with the A parameter 
are those specifying files, L=0, R, *, /, and H. 

An error results if the old program library is not 
sequential or the new program library is not 
random. For SCOPE 2, the new program library 
cannot be blocked. 

0 omitted 

No copy is made. 

• A 

The sequential old program library is 
copied to a random new program library. 


B RANDOM-TO-SEQUENTIAL COPY 

This parameter copies a random old program library 
to a sequential new program library. No other 
Update operations are performed; any I parameter is 
ignored. The only other control statement param¬ 
eters that can be used with the B parameter are 
those specifying files, L-0, R, *, and /. An error 
results if the old program library is not in random 
format. 

0 omitted 

No copy is made. 

0 B 

The random old program library is copied to 
a sequential new program library. 

C COMPILE FILE NAME 

This parameter specifies the name of the compile 
file. The content of the compile file is 
determined by the Update mode as shown in table 2-2 
in section 2, The default character set is display 
code, 

0 omitted or C or C 6 or C 8 

Decks are written to the file named COMPILE. 
0 C=lfn or C 6 -lfn or C 8 =lfn 

Decks are written to file named Ifn. 
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® C«PUNCH 


D DATA WIDTH ON COMPILE FILE 


Decks are written to file named PUNCH, The 
D and 8 parameters are implied. 

® C^O 

Compile file suppressed. 

The C parameter is ignored if K is also specified. 

TABLE 4-1 SUMMARY OF UPDATE 


This parameter specifies how many columns are to be 
used for data on the COMPILE file. Data width does 
not Include sequencing Information. 

• omitted 

72 columns of data to be used. 

• D 

80 columns of data to be used. 

CONTROL STATEMENT PARAMETERS 


Parameter^ 

1 . 

Function 



A 

Copies a sequential old program library to a new random program library. 

B 

Copies a random old program library to a new sequential old program library. 

C 

Specifies the name of the compile file. 

D 

Defines the compile file line image width, excluding Update sequence information. 

E 

Removes from the directory previously purged identifiers and purge identifiers that exist 
simply as directory entries. 

F 

Selects full Update mode. 

G 

Specifies the name of the pullmod file. 

H 

Overrides the old program library character set. 

I 

Specifies the name of the primary input files. 

K 

Writes decks on compile file in order specified on COMPILE directives. 

L 

Selects listable output file contents. 

M 

Merges specified program library with an old program library. 

N 

Specifies the name of the new program library file. 

0 

Specifies the name of the listable output file; content is determined by L parameter. 

P 

Specifies the names of the old program library and secondary old program libraries. 

Q 

Selects quick update mode. 

R 

Specifies the particular files to rewind. 

S 

Specifies the name of the source file; content includes common decks and is determined by 
mode. 

T 

Same as S, but omits common decks, 

U 

Does not terminate execution if fatal error occurs• 

W 

Specifies the sequential new program library file. 

X 

Specifies the compressed format for the compile file. 

8 

Defines the compile file line image width including Update sequence information. 

* 

Redefines the master control character for directives. 

i / 

Redefines the control character for comments. 

^ParameterB C, G, I, K, M, N, 0, P, S, and T can be appended with either 6 (for display code) or 8 
(for ASCII). 
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If specified, the WIDTH directive overrides the D 
parameter. 

E EDIT OLD PROGRAM LIBRARY 

This parameter specifies that the old program 
library is to be edited. During editing, the 
directory and deck list are rearranged to reflect 
the actual order of decks on the program library; 
all previously purged identifiers are removed. 
Identifiers that exist simply as entries in the 
directory and have no lines associated with them 
are purged. Any lines other than YANK, SELYANK, 
YANKDECK, or DEFINE that exist in the YANK$$$ deck 
are also purged. 

Two edit runs are required to edit the library 
completely. The first edit run removes purged 
identifiers and flags unused identifiers as 
purged. The second edit run deletes the unused 
identifiers from the directory, 

• omitted 

No editing is done. 

• E 

The program library is edited. 

The E parameter can only be used when the EDITKEY 
installation option has been assembled for Update. 

F FULL UPDATE MODE 

This parameter specifies full Update mode. 

• omitted 

Normal selective Update mode, as long as Q 
is not specified. 

• F 

Full Update mode. 


G PULLMOD FILE NAME 

This parameter specifies the name of the pullmod 
file. The default character set is display code. 
The G parameter can only be used when the PMODKEY 
installation option has been assembled for Update. 

9 omitted 

Output from PULIWOD directives is appended 
to the source file (S parameter). 

9 G=»lfn or G6*lfn or G8=»lfn 

Out put f r om PULLMOD directives is writ ten 
on file named Ifn. The listable output 
file (0 parameter) cannot be specified. 


H CHARACTER SET CHANGE 

This parameter allows the user to override the 
character set type specification in the old program 
library. 


9 omitted or H 

Update treats the old program library 
character set as the character set 
indicated in the old program library. 

9 H»3 

Update treats the old program library as a 

63- character set program library regardless 

of the character set specified in the old 

program library, 

9 H»4 

Update treats the old program library as a 

64- character set program library regardless 

of the character set specified in the old 

program library, 

I INPUT STREAM FILE NAME 

This parameter specifies the name of the primary 

input file. If the digit 6 or 8 is not specified 
(I or I“lfn), Update determines the input file 
character set by examining the first line image. 
Direct input from terminals, permitted only on NOS 
and NOS/BE, defaults to the display code character 
set unless 18 is specified on the UPDATE control 
statement. All auxiliary input files must be in 
the same character set as the primary input file. 
Input lines are read and stored up to 256 char¬ 
acters in length. No special parameter is nec¬ 
essary to use long lines. Lines exceeding 256 

characters are truncated and an informative message 
is issued. 

9 omitted or I or 16 or 18 

Directives and text are on the file named 
INPUT. 

9 I*lfn or I6=“lfn or I8=lfn 

Directives and text are on file named Ifn. 

K COMPILE FILE SEQUENCE 

This parameter specifies that decks are to be 
written to the compile file in the order in which 
the deck names are encountered on CCMPILE 
directives. If a deck name is mentioned more than 
once, its last specification determines the deck^s 
place within the compile file. The default 
character set is display code (K6). This parameter 
takes precedence over the C parameter. The K | 
parameter is ignored if both the K parameter and | 
the F parameter are specified, | 

9 omitted 

Location determined by C parameter. 

. K or K6 or K8 | 

Decks to be written to the file named 
COMPILE in COMPILE directive sequence. 

9 K=lfn or K6“lfn or K8=lfn 

Compile output decks to be written on file 
named Ifn in COMPILE directive sequence. 
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L USTABLE OUTPUT OPTIONS 


This parameter specifies the content of the output 
file. 

« omitted 

For a creation run, selects options A, 1, 
and 2, 

For a correction run, selects options A, 1, 
2, 3, and A. 

For a copy run, selects options A and 1. 

For an output file connected to a terminal, 
selects option 1. 

o L~c...c 

Each character in string c,..c selects one 
of the following options. Under NOS, up to 
seven options can be specified. The 
character 0 overrides any other options 
specified and suppresses the entire listing. 

A List known deck names and correction 
set identifiers (deck names and 
correction set identifiers must be on 
the primary old program library to be 
known), COMDECK directives that were 
processed, known definitions (DEFINE 
directive), and decks written to the 
compile file. 

F All options except 0. 

0 All listing is suppressed. 

1 List lines in error and the associated 
error messages. The flag *ERR0R* 
appears to the left and right of an 
erroneous line image, 

2 List all active Update directives 

encountered either on the input file or 
on the old program library. Those 
directives encountered in input are 

flagged with five asterisks to the left 
unless the directive is abbreviated or 
the line identifier is in short form. 
In this case, the directive is flagged 
with five slashes. If the directive 
has been encountered on the old program 
library, the name of the deck to which 
this line belongs is printed in place 
of the five asterisks or slashes, 

3 Comment on each line that changed 
status during current run. Comments 
include the deck name, line image, line 
identifier, and an indicator of action 
taken for that line. 

I Line added. 

A Inactive line reactivated. 

D Active line deactivated. 

P Line purged. If the line was 
active, ACTIVE also appears. 

SEQ Line resequenced. 


4 List text lines encountered in the 
input stream. Lines read as a result 
of a READ directive are identified to 
the right with the file name- Lines 
inserted as a result of an ADDFILE 
directive are listed only when option 4 
is explicitly selected. Lines inserted 
as a result of a COPY directive are 
identified to the right by the word 
copy. 

Option 4 can be turned on by a LIST 
directive and off by a NOLIST directive. 

5 List all active compile file directives. 

6 List number of active and inactive 

lines by deck name and correction set 
identifier, 

7 List all active lines; identify to the 

right with an A. 

8 List all inactive lines; identify to 
the right with an I, 

9 List correction history of all lines 

selected by list options 5, 7, and 8. 

List options 5 through 9 are provided for auditing 
an old program library. These options are 

available only when the AUDITKEY installation 
option is assembled. Output is written to a 
temporary file and appended to the listable output 
file at the end of the Update run. When the F 
parameter is selected, options 5 through 9 apply to 
all decks on the old program library. If • F is not 
selected, options 5 through 9 apply to decks listed 
on COMPILE directives only. 

List options 3, 5, 6, 7, 8, and 9 do not apply to 
creation runs and are ignored if specified. 
However, list option 4 may be used to list creation 
run input• 

If the A or B parameter is specified, the only list 
option honored is L»0, 

If the old program library is sequential and F is 
not selected, called common decks that precede the 
decks that call them must be explicitly named on 
COMPILE directives to be audited. A common deck is 
audited automatically if it follows the deck that 
calls it. If the old program library is random, 
called common decks are audited automatically. 


M MERGE PROGRAM LIBRARIES 

This parameter merges two program libraries as one 
new program library. The M parameter is ignored on 
a creation run. The two program libraries must 
have the same master control character. The 
default character set is determined from the header. 

• omitted 

No merge file. 

• M or M6 or M8 

Program library to be merged with the old 
program library is on file MERGE, 
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• M-lfn 


Q QUICK UPDATE MODE 


Program library to be merged with old 
program library on file named Ifn. 


N NEW PROGRAM LIBRARY FILE NAME 

This parameter specif ies the name of the new 
program library. The default character set is 
ASCII if the P, M, or I file uses ASCII. 

9 omitted 

Suppress new program library generation if 
correction run, otherwise write new program 
library to file named NEWPL. 

« N or N6 or N8 

Write new program library to file named 
NEWPL. 

® N=»lfn or N6=lfn or N8=®lfn 

Write new program library to file named Ifn. 


O LISTABLE OUTPUT FILE NAME 

This parameter specifies the name of the output 
file. Output file content is determined by the L 
parameter. The default character set is display 
code. 

• omitted or 0 or 06 or 08 

Write output to file named OUTPUT, 

9 0=lfn or 06*lfn or 08=lfn 

Write output to file named Ifn. 


P OLD PROGRAM LIBRARY FILE NAME 

This parameter specifies the name of the old 
program library; it is ignored on a creation run. 

The default character set is determined from the 
header. 

9 omitted or P or P6 or P8 

Old program library resides on file named 

OLDPL. 

« P=»lfn 

0 Id p ro gram libra ry resides on file named 

Ifn. 

® P»lfn/sl/s2/.../s7 

Old program library resides on file named 

Ifn. Secondary old program libraries 
reside on files si, s2,..,,s7. 

9 P=*/s 1/82/,.,/s7 

Old program library resides on file OLDPL. 
Secondary old program libraries reside on 
files si, s2,... ,s7 . 


This parameter specifies quick Update mode. It 
takes precedence when both F and Q are specified. 

9 omitted 

When F is also omitted, normal selective 
Update mode. 

® Q 

Quick mode. 

Corrections other than ADDFILE that reference lines 
in decks not specified on COMPILE directives are 
not processed in quick mode and Update abnormally 
terminates after printing the unprocessed correc¬ 
tions. 

In Q mode, using a random old program library, a 
single correction set containing corrections to 
both a DECK and a COMDECK might cause trouble if 
the COMDECK logically precedes the DECK on the old 
program library. No errors will be detected, but 
if the same run is repeated with the N parameter 
specified on the UPDATE control statement and/or 
the old program library is sequential, the sequence 
numbers assigned to the text lines in the 
correction set will not be the same as they were in 
the Q mode run. This situation cannot be prevented 
without sacrificing the speed for which Q mode was 
designed. The correct sequence numbers are those 
assigned when N is specified or the old program 

library is sequential, 

R REWIND FILES 

This parameter specifies files to be rewound before 
and after an Update run. 

9 omitted 

Rewind the old program library, the new 
program library, the compile file, the 
source file, and the pullmod file. 

• R 

Do not rewind any files. The new program 

library and the old program library are 
positioned before the end-of-file mark. 

9 R*c..-c 

Each character in the string indicates a 
file to be rewound. The characters also 
apply to corresponding two-character 
control statement options. 

C Compile 

N New program library 

P Old program library and merge library 

S Source and pullmod 
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S SOURCE FILE NAME 


W SEQUENTIAL NEW PROGRAM LIBRARY FORMAT 


This parameter specifies the name of the source 
file. The content of the source file is determined 
by the mode in which Update is operating, by the 
decks named on COMPILE directives, and by the 
format of the old program library in use (random or 
sequential). 


• omitted 

Suppress source output file unless it is 
selected by the T parameter. 

e S or S6 or S8 

Source output file to be written on file 

named SOURCE. 

o S=lfn or S6=lfn or SS-lfn 

Source output file to be written on file 

named Ifn. 


T OMIT COMMON DECKS FROM SOURCE FILE 

This parameter specifies that common decks are to 
be excluded from the source file. It takes 
precedence over the S parameter. 

9 omitted 

Suppress source file unless it is selected 
by the S parameter. 

« T or T6 or T8 

Source output to be written on file named 
SOURCE, with common decks excluded, 

e T=lfn or T6-lfn or T8-lfn 

Source output to be written on file named 
Ifn, with common decks excluded. 


U DEBUG HELP 

The U parameter allows Update to proceed to pass 2 
(correction phase) if errors are encountered in 
pass 1 (read“input-stream phase). The user should 
be aware that because of the method in which Update 
works, pass 1 errors could conceivably cause the 
flagging of pass 2 items which are not errors. 


• omitted 

Update execution terminates when a fatal 
error is encountered. 

« U 

Update execution is not terminated by a 
fatal error. 


This parameter specifies that the new program 
library is to have sequential format. 

• omitted 

New program library format is determined by 
file residence as shown in table 2-3 in 
section 2. 

• W 

New program library is a sequential file. 

X COMPRESSED COMPILE FILE 

This parameter specifies that the compile file is 
to be compressed. 

• omitted 

Compile file is not written in compressed 
format. 

• X 

Compile file is written in compressed 
format (appendix D). 


8 LINE IMAGE WIDTH ON COMPILE FILE 

This parameter specifies total line image width on 
the compile file including sequencing information 
(appendix D). 


• omitted 





Compile 

90-column 

file 

line 

output 
images. 

is composed 

of 

• 8 





Compile 

80-column 

file 

line 

output 
images. 

is composed 

of 


If specified, the WIDTH directive overrides the 8 
parameter. 


MASTER CONTROL CHARACTER 

This parameter specifies the master control 
character. If the character specified for a 
correction run is not the same as the character 
used when the old program library was created, the 
old program library character is used, 

• omitted 

The first character of each directive is *. 

• *«“C 

The first character of each directive for 
this Update run is c; c can be any 
character A through Z, 0 through 9, or + - 
* / $ or (The $ character should be 

specified as *=$$$$.) 
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/ COMMENT CONTROL CHARACTER 

This parameter specifies the comment control 
character. 

® omitted 

Conanent control character is /• 

• /=c 

The comment control character is c; c can 
be any charac ter A through Z, 0 through 9, 
or 4* - * / $ or *, (The $ character should 
be specified as /*$$$$.) Note, however, 
that the character should not be changed to 
one of the abbreviated forms of a directive 
unless NOABBREV is in effect. 


UPDATE CONTROL 
STATEMENT EXAMPLES 

The Update control statement 

UPDATE(C=*0,I=IN,L«F,N«TEST2,P*TEST1 ,S,*»+) 

selects the following options in addition to 
default values for the omitted parameters: 

« C=0 

A compile file is not generated, 

9 I-IN 

The input stream is on the file named IN, 

® L-F 

A full output listing is generated. 

9 N«TEST2 

A new program library named TEST2 is 
generated. 

® POTEST1 

The oId p rog ram 1ibrary is on the file 
named TESTl. 

$ S 

A source file is generated on file named 
SOURCE. 

o *=>+ 

The master control character is 4-, 

The Update control statement 

UPDATE (P-0LDPL8, S8,1,0.N6=«NUPL6) 
selects the following values: 

9 P«0LDPL8 

Modify the program library named 0LDPL8; 
the program library is assumed to be in 
ASCII. 


9 S8 

Generates an ASCII source file named 
SOURCE. 

• ^ 

The input is in ASCII or display code on 
the file named INPUT. Update automatically 
determines the character set of the input 
file. 

9 0 

The output is in display code (the default) 
on the file named OUTPUT,. _ 

9 N6=NUPL6 

Causes Update to generate a new program 
library in display code from the old 
program library in ASCII code on the file 
named NUPL6. 


The Update control statement 
UPDATE(C-0,I«0,N8»NUPL8,S) 
selects the following options: 


e N8*NUPL8 

' An 8-bit (ASCII) NEWPL is generated if an 
ASCII old program library is input, 

9 C“0 

A compile file is not generated, 

« 1*0 

The 0 is an empty file; no corrections are 
applied. 

« S 

A source file in display code named SOURCE 
is generated. 

The Update control statement 
UPDATE(A,N=RAN,P*SEQ) 

causes Update to copy the sequential old program 
library, SEQ, to a random new program library named 
RAN. The L, 0, R, *, and / parameters assume 
their default values. No other parameters are 
applicable when A is specified. 


The Update control statement 
UPDATE 

selects the following default values: 
9 C=C0MPILE 

9 G=S0URCE (correction run) 
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$ I»INPUT 

o L«A12 (creation run) 

L“A1234 (correction run) 

L«A1 (copy run) 

B N*NEWPL (creation run) 

B 0-OUTPUT 

• R-CNPS 

B P-OLDPL (correction run) 

^ icmit 

9 /-/ 

In addition, the following defaults apply: 

• The compile file has 90 columns with 72 columns 
for data. 

9 No editing is performed. 

• Update mode is normal selective. 

9 The character set used is that specified in the 
library header. However, if there is ASCII 
data in INPUT, ASCII will be used in creating 
NEWPL. 

® No merging is performed. 

9 Execution is terminated if a fatal error occurs. 

9 New program library file format is determined 

by file residence. 

• The compile file is not in compressed format. 


The Update control statement 

UPDATE(C8-C812,F,I-F64,L-1,N-0,0-OUT,S8-S812,U) 

causes Update to convert display code data in file 
F64 to ASCII data in file C812. The statement 
selects the following options: 

• C8-C812 

A compile file is generated in ASCII. 

• F 

Full Update mode is used. 

• I-F64 

The input stream is on the file named F84. 
A *DECK directive must be the first line in 
the file. 

• L*1 

The output file will contain lines in error 
and the associated error messages. 

• N-0 

A new program library is not generated. 

• O-OUT 

The output is written to the file named OUT. 

• S8-S812 

An ASCII source file is generated on file 
named S812. 

• U 

The Update execution will not be terminated 
by a fatal error. 
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EXAMPLES OF UPDATE RUNS 


B 


This section contains several examples of Update 
I runs under NOS, The directives illustrated include 
PURGE, YANK, ADDFILE, and PULLMOD. Examples also 
show how to save or store a program library as a 
permanent file under the various operating 
systems. Also included in this section is an 
example of a FORTRAN program maintained as a 
program library. 


LIBRARY FILE CREATION 

Figure 5-1 shows an example of an Update creation 
run in which several COMPASS and FORTRAN routines 
become a program library. The UPDATE control 
statement indicates a new library is to be created 
with the name PL, Since no other parameters are 
specified. Update uses default values. 


job statement 


UPDATE(N=PL) 


I /EOR 

♦DECK CONGROUP 
COMPASS program 
★DECK C0M6R0UP1 
COMPASS program 
★WEOR 

★DECK F0R6R0UP 
FORTRAN program 
★DECK F0RGR0UP1 
FORTRAN program 
I /EOI 


Figure 5-1. Update Creation Run 


Since the first directive encountered is DECK, 
Update recognizes a creation run and begins 
I construction of a new program library. All lines 
following the first DECK directive, up until the 
second DECK directive, are written as a deck with 
§ the name COMGROUP. The first line is assigned the 
identifier COMGROUP.2, the next COMGROUP.3, and so 
forth. (The DECK directive itself is also a part 
of the library and has the identifier COMGROUP.1.) 


I A new deck, with line identifiers in the form 
COMGROUPl.n, begins when Update encounters the 

second DECK directive. In this example 
(figure 5-1), two COMPASS programs form the first 
two decks; COMGROUP and COMGROUP 1; and two FORTRAN 
programs make up the last two decks (FORGROUP and 
FORGROUPl). At the end of the Update run, a 

program library exists with four decks. 


The compile file produced by the run in figure 5-1 
contains two system-logical records as a result of 
the WEOR directive. All four decks are written to 
the compile file. It has the default name of 
COMPILE. 

The example in figure 5-2 shows a creation run in 
which directives are read from the alternate input 
file REMTAPE. Update reads text and directives 
from REMTAPE until the end of the system-logical 
record (end-of-section for SCOPE 2) is encoun¬ 
tered. Update then resumes reading from the main 
input file, INPUT. The resulting new program 
library contains decks A, B, C, and LOCAL. 


A. Update Job Deck, 
job statement 


UPDATECN) 


/EOR 

★READ REMTAPE 
★DECK LOCAL 
text of LOCAL 
/EOI 

B. Contents of REMTAPE 

★DECK A 
text of A 
★DECK B 
text of B 
★DECK C 
text of C 


I 


Figure 5-2. Creation of Library 
From Alternate Input File 

The program library, NEWPL, created by the example 
in figure 5-3 contains four decks; two of them are 
common decks. The compile file that is produced by 
default contains decks XA and XB in that order. 
Deck XB is expanded by Update to contain common 
deck D2 on the compile file- 


ALTERNATIVE INPUT FILES I 

Text and directives do not have to be part of the 
job deck. They can be in a file specified by the I 
parameter of the UPDATE control statement. In 
figure 5-4, Update creates a program library from 
information contained in file Ai. The library that 
is produced contains three decks having lines I 
identified by their deck name and sequence number 
as shown in figure 5-5. 
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job statement 


UPDATE(N) 


/EOR 

★COMDECK D1 
- text of D1 
★COMDECK D2 
text of D2 
★DECK XA 
text of XA 
★DECK XB 
text of XB 
★CALL D2 
/EOI 


Figure 5-3. Creation of Library 
With Common Decks 


A. Update Job Deck 
job statement 


UPDATE(I=A1^N) 


/EOI 

B. Contents of Al 

★COMDECK CSET 

COmON A,B,C 

★DECK SET1 

PROGRAM ZIP 

C A DO-NOTHING JOB 
STOP 
END 

★DECK SET2 

SUBROUTINE JIM 
A = B - SINCC) 
RETURN 
END 


Figure 5-4. Input File Not INPUT 


★COMDECK CSET 

CSET.1 

COWON A,B,C 

CSET.2 

★DECK SETl 

SET1.1 

PROGRAM ZIP 

SETl-2 

C A DO-NOTHING JOB 

SETl.3 

STOP 

SETl.4 

END 

SETl.5 

★DECK SET2 

SET2.1 

SUBROUTINE JIM 

SET2.2 

A = B - SIN(C) 

SET2.3 

RETURN 

SET2.4 

END 

SET2.5 

Figure 5-5. Program Library 

Contents 


INSERTING, DELETING, 

AND COPYING 

The Update run illustrated in figure 5-6 modifies 
the decks SETl and SET2 of the program library 
created by the run in figure 5-4. As a result of 
the correction run, SETl appears in the compile 
file as shown in figure 5-7. 


job statement 


UPDATE(N^F) 


/EOR 

★IDENT ADD1 
★DELETE SET1.3^SET2.5 
★CALL CSET 

B=1.0 
C:=3.14159 
CALL JIM 

★COPY SET1,SET1.4,SET1.5 
★COPY SET2,SET2.2 
★CALL CSET 

★COPY SET2,SET2.3^SET2.5 
/EOI 


Figure 5-6. Modify Old Program Library 


PROGRAM ZIP 

SETl 

2 

COMMON A,B,C 

CSET 

2 

B=1 .0 

A0D1 

2 

C=3.14159 

ADD1 

3 

CALL JIM 

ADD1 

4 

STOP 

ADD1 

5 

END 

ADD1 

6 

SUBROUTINE JIM 

ADD1 

7 

COmON A^B^C 

CSET 

2 

A = B - SINCC) 

ADD1 

9 

RETURN 

ADD1 

10 

END 

ADD1 

11 


Figure 5-7. Compile File Contents 


Figure 5-8 shows the modification of an old program 
library named FN and the production of an assembly 
listing. The compile file that is read by COMPASS 
contains deck XA after that deck was modified by 
Update. 


PURGING AND YANKING 

The purge directives differ from the yank 
directives in that yank operations are temporary; 
lines yanked from the program library are tem¬ 
porarily deactivated. The lines can be reactivated 
by a subsequent yank of the yank directive that 
deactivated the line images. 

In contrast, any change made to a program library 
through a purge directive is permanent. A reversal 
of a purge operation is possible only through the 
reintroduction of the lines into the library as if 
they had not previously existed. 
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job statement 


job statement 

UPDATE(P=FN) 


• 

UPDATE (N=LIBHAY,P=LIBALIG,C=0) 

COMPASS(I=C0NPILE) 


/EOR 



.PURGE JUNMODl,* 



/EOI 

/EOR 



♦IDEMT CS1 


Figure 5-10. Return to Previous Level 

.INSERT XA.1 



Insertions 


- - 

.DELETE XA.20,XA.23 

library modified only through May. The run purges 

/EOI 

all modifications made after May (beginning with 


JUNMODl in the directory). 


Figure 5-8. Correction Run 


The YANK directive in figure 5-9 becomes the first 

I line on the new program library. The identifier 
for this line is NEGATE.1. The effects of the YANK 
can be nullified in future runs (consequently the 
effects of the correction set GOTTOGO are restored) 
by specifying the following: 

*IDENT RESTORE 
*DELETE NEGATE.1 
or 

*]DENT RESTORE 
★YANK NEGATE 
or 

★PURGE NEGATE 


I 

I 


job statement 


UPDATE(P^LIB^N=NEWLIB) 


/EOR 

★IDEKT NEGATE 
★YANK GOTTOGO 
/EOI 


Figure 5-9. Use of YANK 

If the correction set NEGATE contained other 
corrections as well as the YANK, the YANK could be 
permanently removed by specifying the following: 

★SELPURGE YANK$$$.NEGATE 

or it could be temporarily removed by specifying: 
★SELYANK YANK$$$.NEGATE 

The Update run in figure 5-10 returns a program 
library to a previous level. The program library 
LIBAUG was modified periodically over a number of 
months. LIBAUG is the most recent (August) version 
of the program library. This run re-creates a 


The run in figure 5-11 permanently removes deck BAD 
from the library. LIB is the most recent program 
library. NEWBAD is the new program library with 
RAD purged. ★PURDECK BAD operates so that any 
lines having the identifier BAD but physically | 
located outside of the deck BAD are not purged. 


job statement 


UPDATE(P=LIB,N=NEWBAD,C=0) 


/EOR 

★PURDECK BAD 
/EOI 


Figure 5-11. Use of PURDECK 

As a means of comparing the effects of YANK, 
SELYANK, and YANKDECK. consider the following: 

9 *YANK OLDMOD 

This directive causes all effects of the 

correction set OLDMOD on the entire library to 
be nullified. Line images introduced by OLDMOD § 
are deactivated; line images deactivated by | 

OUMOD are reactivated. 

® *SELYANK OLDDECK.OLDMOD 

This directive accomplishes the same effect as 
the ★YANK OLDMOD directive except its effect is 
limited to line images within the deck OLDDECK. | 

9 *YANKDECK OLDDECK 

This directive affects all line images in | 

OLDDECK, without regard to which correction set 
they belong. 


The effects of the purge directives PURGE, 
SELPURGE, and PURDECK work the same as the yank 
directives except the results are permanent. 
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SELECTIVE YANKING 

The text stream in figure 5~12 illustrates the use 
of the DO and DONT directives. The deck ZOTS had 
contained lines introduced by the correction set 
DART; a later correction set contained a YANK 
directive that yanked correction set DART. The 
user wishes to nullify a portion of the YANK 
directive that affects the lines following ZOTS.19 
through Z0TS.2A4; all other lines belonging to the 
correction set DART are to remain yanked. 
Inserting a DO at ZOTS. 19 and a DONT at ZOTS.244 
causes Update to rescind the YANK directive while 
writing the deck ZOTS to the compile file. 


★IDENT 

REST 

★INSERT 

ZOTS.19 

★ DO 

DART 

★INSERT 

ZOTS.244 

★DONT 

DART 


Figure 5-12, Use of DO and DONT 


SELECTIVE WRITING TO 
COMPILE FILE 


During the correction phase Update processes the 
following directive: 

★DEFINE ABC 


It is automatically placed in the YANK$$$ deck 
(★INSERT is not needed). PR0G2, a deck to be 
written on the compile file, contains the sequence 
shown in figure 5-13. 


★DECK PR062 

★IF DEF^ABC 

★ENDIF 


Figure 5-13, Sequence of Deck 


Since ABC is defined, all active lines between the 
IF and ENDIF pair are written as part of PR0G2. 
Removing the DEFINE from the YANK$$$ deck would 
cause these text lines to be skipped. 


★DECK OECKA . 


★IF IDENT^IDC,15 
★IF - IDENT^IDC 
active text Lines 
★ENDIF 


I 


Figure 5-1A. Use of IF and ENDIF I 

Nesting of IF directives is illustrated in 

figure 5-15. The deck ROCK has an IF-controlied | 

sequence containing a second IF-controlled 
sequence. The text following the first IF is 
written if PEBBLE is known (on the old program 
library); the text following the second IF is 
written if both PEBBLE and STONE are known. The 
ENDIF terminates both IF-controlled sequences. 


★DECK ROCK 

★IF IDENT^PEBBLE 

★IF IDENT,STONE 

m 

m 

★ENDIF 

Figure 5-15, Nested IF Directives | 


ADDITION OF DECKS 

A new program library, NEWPL, is constructed from 
the old program library, OLDPL, with the addition 
of one new common deck and two new decks. The new 
common deck, DIA, is the first deck after the 

YANK$$$ deck; the new deck XC follows deck SX; and 
the new deck SYSTEXT is the last deck on the new 
program library. No compile file is produced. All 
three of the ADDFILEs in figure 5-16 are to be read | 
from the main input file INPUT. The ADDFILEs in I 
figure 5-17 are to be read from the Update input | 
file FNAME. In both these cases, the input file 

need not be specified but the two separators must 

be included (either space and comma or two 

commas). Each of the ADDFILE directives in 
figure 5-18 causes Update to read from a separate | 
file that is not the main input file. Common deck 
DIA and its text are on FII£A; deck SYSTEXT and its 
text are on FILEB; deck XC and its text are on 
FILEC. 


The input stream in figure 5-14 has mutually 
exclusive requirements depending on the avail¬ 
ability of correction set IDC. If IDC is known, 
the first 15 active lines after the first IF are 
written to the compile file. If IDC is not known, 
the lines following the second IF through the ENDIF 
are written to the compile file. 


PULLMOD OPTION 

The program library created by the example in 
figure 5-4 (Input File Not INPUT) has been altered 
by the correction run in figure 5-19. As a con¬ 
sequence of the run, the deck SETl contains the 
lines shown in figure 5-20. 
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job statement 


UPDATE(N,C=0) 


/EOR 

★ADDFILE INPUT,YANK$$$ or *ADDFILE„YANK$$$ 
*COMDECK DIA 


*A0DFILE INPUT or *ADDFILE 
★DECK SYSTEXT 


★ADDFILE INPUT,XB or ★ADDFILE,,XB 
★DECK XC 


/EOI 


Figure 5-16. ADDFILE Input on File INPUT 


f 


A. Update Run 
job statement 


UPDATE(N,C=O^I=FNAME) 


/EOI 

B. Contents of file FNAME 

★ADDFILE FNAME,YANK$$$ or ★ADDFILE,^YANK$$$ 
★COMDECK DIA 


★ADDFILE FNAME or ★ADDFILE 
★DECK SYSTEXT 


★ADDFILE FNAME,XB or *ADDFILE,,XB 
★DECK XC 


I Figure 5-17. ADDFILE Input on File FNAME 


The Update run in figure 5-21 recreates the 
correction set that changed SETl; the file PMFILE 
contains the recreated correction set shown in 
figure 5-22, 


job statement 


UPDATE(N,C=0) 


/EOR 

★ADDFILE FILEA,YANK$$$ 
★ADDFILE FILEB 
★ADDFILE FILEC,XB 
/EOI 


Figure 5-18. ADDFILE Input on 
Secondary Input Files 


job statement 


UPDATECM=PL2) 


/EOR 

★IDENT PHEX 
★DELETE SETl.3 

C THIS IS FOR PULLMOD EXAMPLE 

★COMPILE SETl 

/EOI 


Figure 5-19. Correction Run 
for PULLMOD Example 


★DECK SET1 

PROGRAM ZIP 

C THIS IS FOR PULLMOD EXAMPLE 
STOP 
END 


Figure 5-20. File Contents After 
Correction Run 


job statement 


UPDATE(G=PMFILE,P=PL2) 
/EOR 

★PULLMOD PMEX 
/EOI 


Figure 5-21. Pull Modifications 


★IDENT PHEX 

★DELETE SETl.3,SETl.3 

C THIS IS FOR PULLMOD EXAMPLE 


Figure 5-22. Recreated Correction Run 
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PROGRAM LIBRARY AS A 
PERMANENT FILE 

The job deck in figure 5-23 illustrates the 
creation and saving of a program library as a 
permanent file under NOS/BE and SCOPE 2; the deck 
in figure 5-24 saves a program library as an in- 
direct access file under NOS. See the appropriate 
operating system reference manual for additional 
details. 


job statement 
accounting statements 
REQUEST(PL,*PF) 

UPDATE(N=PL,W,L=1234) 
CATALOGCPL,PLIB,ID=JONES) 
/EOR 

★DECK ONE 


Figure 5-23, Permanent File Under 
NOS/BE or SCOPE 2 


job statement 
accounting statements 
UPDATE(N=PL,W,L=1234) 
SAVE(PL=UPLIB) 

/EOR 

★DECK ONE 


job statement 

• 

• 

UPDATE(N.F) 

FTN5(1 

^COMPILE) 

LGO. 


/EOR 


★DECK 

ONE 


PROGRAM ONE 


PRINT 5 

5 

FORMATdHD 

10 

READ (*,100,END=ia0)BASE,HElGHT 

100 

FORMAT (BZ,2F10.2,11) 


IF (BASE.LE.O) GO TO 105 


IF (HEIGHT.LE.O) GO TO 105 


GO TO 106 

105 

CALL MSG 

106 

AREA . .5 * BASE * HEIGHT 


PRINT 110, BASE,HEIGHT,AREA 

110 

FORMAT (///,'BASES',F20.5,'HEIGHT** 


C ,F18.5,*AREA=',F20.5) 


WRITE (1) AREA 


GO TO 10 

120 

STOP 


END 


SUBROUTINE MSA 


PRINT 400 

400 

FORMAT (///,'FOLLOWING INPUT DATA 


C NEGATIVE OR ZERO') 


RETURN 


END 

/EOR 


data 


/EOI 



Figure 5-25, FORTRAN Program Library 


Figure 5-24. Permanent File Under NOS 


SAMPLE FORTRAN PROGRAM 

This set of Update examples illustrates how Update 
can be used for maintaining a FORTRAN program in 
program library format. The FORTRAN program 

calculates the area of a triangle obtaining the 

base and height from the data record. 

I The job in figure 5-25 places the FORTRAN program 
and subroutine as a single deck (ONE) on the new 

program library (NEWPL) and on the compile file 
(COMPILE). Following Update execution, FTN5 is 
called to compile the program; the source is on the 
COMPILE file. LGO calls for execution of the 

compiled program. This program does not execute 
because of an error in the SUBROUTINE statement. 
The name of the subroutine should be MSG, not MSA. 

Examination of update output from the creation job 
reveals that the erroneous SUBROUTINE statement has 

I line identifier ONE,20. The job in figure 5-26 
corrects the error and generates a new program 
library. 



Figure 5-26. Correction of 


SUBROUTINE Statement 
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I The job in figure 5-27 uses the same input as the 
job in figure 5-25. However, the program in 
figure 5-27 is divided into two decks, MSG and 
ONE. Deck MSG is a common deck. A CALL directive 
is inserted into deck ONE to assure that whenever 
deck ONE is written on the compile file, MSG is 
also written on the compile file. 


I 


I 


job statement 


UPDATECN^F) 

FTN5 CI=C0MPILE) 
LGO. 


/6or 

*COHDECK nSG 

SUBROUTINE NSG 
PRINT 400 

400 FORNAT (///,'FOLLOWING INPUT DATA 
C NEGATIVE OR ZERO') 

RETURN 

END 

*DECK ONE 

PROGRAN ONE 
PRINT 5 

5 FORNAT(IHI) 

10 READ (*,100,END=120)BASE,HEIGHT 

100 FORMAT (BZ,2F10.2,I1) 

IF (BASE.LE.O) GO TO 105 
IF (HEIGHT.LE.O) GO TO 105 
GO TO 106 

105 CAU MSG 

106 AREA = .5 * BASE * HEIGHT 
PRINT 110,BASE,HEIGHT,AREA 

110 FORMAT (///,'BASES',F20.5,•HEIGHT=' 
C ,F18.5,'AREA=',F20.5) 

WRITE (1) AREA 
GO TO 10 

120 STOP 

END 

/EOR 

data 

/EOI 


Figure 5-27. FORTRAN Progra. Library - 2 


The example in figure 5-28 adds a deck to the 
library created in the previous example 
(figure 5-27). Since no new program library is 
generated (N is omitted from Update call), the 
addition is temporary. 


job statement 


m 

ATTACH (OLOPL=^IYLIB) 
UPDATE. 

FTN5(I=C0WPILE> 

LGO. 


/EOR 

*IDENT M0D2 
*INSERT ONE.20 
*DECK TWO 

PROGRAM TWO 


END 

★CALL MSG 
★DELETE MSG.3 

400 FORMAT <///,*FOLLOWING INPUT DATA 
C POSITIVE') 

/EOR 

data 

/EOI 


Figure 5-28. Add Deck to FORTRAN 
Program Library 
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CHARACTER SETS 


A 


This appendix describes the code and character sets 
used by host computer operating system local batch 
device drivers, magnetic tape drivers, and terminal 
conanunication products. Some software products 
assume that certain graphic or control characters 
are associated with specific binary code values for 
collating or syntax processing purposes. This 
appendix does not describe those associations for 
all products. 

All references within this manual to the ASCII 
character set or the ASCII code set refer to the 
character set and code set defined in the American 
National Standard Code for Information Interchange 
(ASCII, ANSI Standard X3o4—1977). References in 
this manual to the ASCII character set do not 
necessarily apply to the ASCII code set. 


CHARACTER SETS AND CODE SETS 

A character set differs from a code set. A 
character set is a set of graphic and/or control 
characters. A code set is a set of codes used to 
represent each character within a character set. 
Characters exist outside the computer system and 
communication network.; codes are received, stored, 
retrieved, and transmitted within the computer 
system and network. 


GRAPHIC AND CONTROL CHARACTERS 

A graphic character can be displayed at a terminal 
or printed by a line printer. Examples of graphic 
characters are the characters A through Z, a blank, 
and the digits 0 through 9. A control character 
initiates, modifies, or stops a control operation. 
An example of a control character is the backspace 
character, which moves the terminal carriage or 
cursor back one space. Although a control 
character is not a graphic character, some ter¬ 
minals can produce a graphic representation when 
they receive a control character. 


CODED AND BINARY CHARACTER DATA 

Character codes can be interpreted as coded 
character data or as binary character data. Coded 
character data is converted from one code set 
representation to another as it enters or leaves 
the computer system; for example, data received 
from a terminal or sent to a magnetic tape unit is 
converted. Binary character data is not converted 
as it enters or leaves the system. Character codes 
are not converted when moved within the system; for 
example, data transferred to or from mass storage 
is not converted. 


The distinction between coded character data and 
binary character data is important when reading or 
punching cards and when reading or writing magnetic 
tape. Only coded character data can be properly 
reproduced as characters on a line printer. Only 
binary character data can properly represent 
characters on a punched card when the data cannot 
be stored as display code. 

The distinction between binary character data and 
characters represented by binary data (such as 
peripheral equipment instruction codes) is also 
important. Only such binary noncharacter data can 
properly reproduce characters on a plotter. 


FORMATTED AND UNFORMATTED 
CHARACTER DATA 

Character codes can be interpreted by a product as 
formatted character data or as unformatted char¬ 
acter data- Formatted data can be stored or 
retrieved by a product in the form of the codes 
described for coded character data in the remainder 
of this appendix, or formatted data can be altered 
to another form during storage or retrieval; for 
example, 1 can be stored as a character code or as 
an integer value. Treatment of unformatted data by 
a product includes both coded character data and 
binary character data as described in this appendix. 

NETWORK OPERATING SYSTEMS 

The Network Operating System (NOS) and the Network 
Operating System/Batch Environment (NOS/BE) support 
the following character sets: 

9 CDC graphic 64-character set 

9 CDC graphic 63-character set 

9 ASCII graphic 64-character set 

9 ASCII graphic 63-character set 

9 ASCII graphic 95-character set 

In addition, NOS supports the ASCII 128-character 

graphic and control set. 

Each installation must select either a 64-character 
set or a 63-character set. The differences between 
the codes of a 63-character set and the codes of a 
64-character set are described under Character Set 
Anomalies. Any reference in this appendix to a 
64-character set implies either a 63- or 64- 
character set unless otherwise stated. 
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To represent its six listed character sets in 
central memory, NOS supports the following code 
sets: 

9 6-bit display code 
& 12-bit ASCII code (ASCII 8/12) 

• 6/12-bit display code (ASCII 6/12) 


Update only utilizes ASCII 8/12 or display code 
characters. No attempt to input ASCII 6/12 data 
(on NOS) should be made. The ASCII 6/12 data must 
first be converted to ASCII 8/12 data using the NOS 
FCOPY control statement. 

To represent its five listed character sets in 
central memory, NOS/BE supports the following code 
sets: 

• 6-bit display code 

«> 12-bit ASCII code (ASCII 8/12) 


Under both NOS and NOS/BE, the 6-bit display code 
is a set of 6-bit codes from OOg to 77g. 


Under both NOS and NOS/BE, the 12-bit ASCII code is 
the ASCII 7-bit code (as defined by ANSI Standard 
X3.4-1977) right-justified in a 12-bit byte. 
Assuming that the bits are numbered from the right 
starting with 0, bits 0 through 6 contain the ASCII 
code, bits 7 through 10 contain zeros, and bit 11 
distinguishes the 12-bit ASCII OOOOg code from 
the end-of-line byte. The 12-bit codes are OOOlg 
through 0l77g and 4000g. 

Under NOS, the 6/12-bit display code is a 
combination of 6-bit codes and 12-bit codes. The 
6-bit codes are OOg through 77g, excluding 
74g and 76g. (The interpretation of the OOg 
and 63g codes is described under Character Set 
Anomalies later in this appendix.) The 12-bit 
codes begin with either 74g or 76g and are 
followed by a 6-bit code. Thus, 74g and 76g 
are considered escape codes and are never used as 
6-bit codes within the 6/12-bit display code set. 
The 12-bit codes are 7401g, 7402g, 7404g, 

7407g, and 7601g through 7677g. All other 
12-bit codes (74xxg and 7600g) are undefined. 


CHARACTER SET ANOMALIES 

The operating system input/output software and some 
products interpret two codes differently when the 
installation selects a 63-character set rather than 
a 64-character set. If an installation uses a 
63-character set, the colon graphic character is 
always represented by a 63g code, display code 
OOg is undefined (it has no associated graphic or 
punched card code), and the % graphic does not 
exist. 


However, under NOS, if the installation uses a 
64-character set, output of a 7404g 6/12-bit 

display code or a OOg display code produces a 
colon. A colon can be input only as a 7404g 
6/12-blt display code. The use of undefined 
6/12-blt display codes in output files produces 
unpredictable results and should be avoided. 


Under NOS/BE, if the installation uses a 
64-character set, output of a OOg display code 
produces a colon. Display code 63g is the colon 
when a 63-character set is used. The 1 graphic and 
related card codes do not exist on the 63-character 
set system and translations yield a blank (55^). 

Under both NOS and NOS/BE, two consecutive OOg 
codes can be confused with an end-of-line byte and 
should be avoided. 


CHARACTER SET TABLES 

The character set tables A-1 and A-2 are designed 
so that the user can find the character represented 
by a code (such as in a dump) or find the code that 
represents a character. To find the character 
represented by a code, the user looks up the code 
in the column listing the appropriate code set and 
then finds the character on that line in the column 
listing the appropriate character set. To find the 
code that represents a character, the user looks up 
the character and then finds the code on the same 
line in the appropriate column. 


Conversational Terminal Users 

Table A-1 shows the character sets and code sets 
available to an Interactive Facility (lAF) user at 
an ASCII code terminal using an ASCII character 
set- (Under NOS using network product software, 
certain Terminal Interface Program commands require 
specification of an ASCII code.) 


lAF Usage 

When in normal time-sharing mode (specified by the 
TAF NORMAL command), lAF assumes the ASCII graphic 
64-character set is used and translates all input 
and output to or from display code- When in ASCII 
time-sharing mode (specified by the lAF ASCII 
command), lAF assumes the ASCII' 128-character set 
is used and translates all input and output to or 
from 6/12-bit display code. 

Update does not support 6/12-bit display code. The 
TAF user can convert a 6/ 12-bit code file to a 
12-bit ASCII code file using the NOS FCOPY control 
statement. The resulting 12-bit ASCII file can be 
routed to a line printer but cannot be output 
through LAF. 
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TABLE A-1. CONVERSATIONAL TERMINAL CHARACTER SETS 


ASCII 

ASCII 

Octal 

Octal 

Octal 

ASCII 

ASCII 

Octal 

Octal 

Octal 

Graphic 

Character 

6-Bit 

6/12-Bit 

12-Bit 

Graphic 

Character 

6-Bit 

6/12-Bit 

12-Bit 

(64-Char- 

C128-Char- 

Display 

Display 

ASCII 

(64-Char- 

(128-Char- 

Display 

Display 


acter Set) 

acter Set) 

Code 

Code^ 

Code 

acter Set) 

acter Set) 

Code 

Codet 


: coLon^^ 


oo^t 




^ circumflex 


7402 

0136 

A 

A 

01 


0101 


: colon 


7404^^ 

0072 

B 

8 

02 


0102 


grave accent 


7407 

0140 

C 

C 

03 


0103 


a 


7601 

0141 

D 

D 

04 


0104 


b 


7602 

0142 

E 

E 

05 

05 

0105 


c 


7603 

0143 

F 

F 

06 

06 

0106 


d 


7604 

0144 

6 

G 

07 

07 

0107 


e 


7605 

0145 

H 

H 

10 

10 

0110 


f 


7606 

0146 

I 

I 

11 

11 

0111 


g 


7607 

1047 

J 

J 

12 

12 

0112 


h 


7610 

0150 

K 

K 

13 

13 

0113 


i 


7611 

0151 

L 

L 

14 

14 

0114 


j 


7612 

0152 

n 

M 

15 

15 

0115 


k 


7613 

0153 

N 

N 

16 

16 

0116 


1 


7614 

0154 

0 

0 

17 

17 

0117 


m 


7615 

0155 

P 

P 

20 

20 

0120 


n 


7616 

0156 

Q 

Q 

21 

21 

0121 


0 


7617 

0157 

R 

R 

22 

22 

0122 


P 


7620 

0160 

S 

S 

23 

23 

0123 


q 


7621 

0161 

T 

T 

24 

24 

0124 


r 


7622 

0162 

U 

U 

25 

25 

0125 


s 


7623 

0163 

V 

V 

26 

26 

0126 


t 


7624 

0164 

u 

w 

27 

27 

0127 


u 


7625 

0165 

X 

X 

30 

30 

0130 


V 


7626 

0166 

Y 

Y 

31 

31 

0131 


w 


7627 

0167 

1 

Z 

32 

32 

0132 


X 


7630 

0170 

0 

0 

33 

33 

0060 


y 


7631 

0171 

1 

1 

34 

34 

0061 


z 


7632 

0172 

2 

2 

35 

35 

0062 


< left brace 


7633 

0173 

3 

3 

36 

36 

0063 


j vert, line 


7634 

0174 

4 

4 

37 

37 

0064 


> right brace 


7635 

0175 

5 

5 

40 

40 

0065 


ti Ide 



0176 

6 

6 

41 

41 

0066 


NUL 



4000 

7 

7 

42 

42 

0067 


SOH 



0001 

8 

8 

43 

43 



STX 



0002 

9 

9 

U 

U 

0071 


ETX 



0003 

+ plus 

+ plus 

45 

45 

0053 


EOT 



0004 

- minus 

- minus 

46 

46 

0055 


ENQ 



0005 

* asterisk 

* asterisk 

47 

47 

0052 


ACK 



0006 

/ slash 

/ slash 

50 

50 

0057 


BEL 



0007 

( 1. paren. 

( 1. paren. 

51 

51 

0050 


BS 



0010 

) r- paren- 

) r- paren. 

52 

52 

0051 


HT 


7651 

0011 

S dollar 

$ dollar 

53 

53 

0044 


LF 


7652 

0012 

= equal to 

= equal to 

54 

54 

0075 


VT 


7653 

0013 

space 

space 

55 

55 

0040 


FF 


7654 

0014 

^ CO ^ran3 

f COn^3 

56 

56 

0054 


CR 


7655 

0015 

. period 

. period 

57 

57 

0056 


SO 


7656 

0016 

# number 

# number 

60 

60 

0043 


SI 


7657 

0017 

r 1. bracket 

r 1. bracket 

61 

61 

0133 


DEL 


7637 

0177 

1 r. bracket 

1 r. bracket 

62 

62 

0135 


DLE 


^■issSH 

0020 

X percent^^ 

X percent^^ 

63^^ 

63^^ 

0045 


DC1 



0021 

" quote 

" quote 

64 

64 

0042 


0C2 


Hie 9 

0022 

^ underline 

_ underline 

65 

65 

0137 


DC3 



0023 

! exclam. 

! exclam. 

66 

66 

0041 


DC4 


7664 

0024 

& ampersand 

S ampersand 

67 

67 

0046 


NAK 


7665 

0025 

* apostrophe 

* apostrophe 

70 

70 

0047 


SYN 



0026 

? question 

? question 

71 

71 

0077 


ETB 



0027 

< less than 

< less than 

72 

72 

0074 


CAN 



0030 

> grtr- than 

> grtr. than 

73 

73 

0076 


EM 



0031 

S coml. at 

74 




SUB 



0032 

\ rev, slant 

\ rev. slant 

75 

75 

0134 


ESC 



0033 

^ circumflex 


76 




FS 



0034 

; semicolon 

; semicolon 

77 

77 

0073 


GS 



0035 


3 coml. at 


7401 

0100 


RS 



0036 






_ 


7677 

0037 

^Generally a 

vailable only 

on NOS, 

or through 

BASIC on NOS/BE. 




^Whe interpretation of this character or code depends on its context. Refer to Character : 

Set Anomalies in 

1 the text. 
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TABLE A-2. LOCAL BATCH DEVICE CHARACTER SETS 


CDC 


ASCII 


ASCII 

Octal 

Octal 

Octal 

Card Keypunch Code 

Graph!c 


Graphic 


Graphic 

6-Bit 

6/12-Bit 

12-Bit 







(64-Character 

(64-Character 

(95-Character 

Display 

Display 


026 

029 

Set) 


Set) 


Set) 

Code 

o 

o 

Q. 




: coLon^^ 


colon 



00^’ 



8-2 

8-2 

A 

A 


A 


01 

01 

0101 

12-1 

12-1 

B 

B 


B 


02 

02 

0102 

12-2 

12-2 

C 

C 


C 


03 

03 

0103 

12-3 

12-3 

D 

D 


D 


04 

04 

0104 

12-4 

12-4 

E 

E 


E 


05 

05 

0105 

12-5 

12-5 

F 

F 


F 


06 

06 

0106 

12-6 

12-6 

6 

G 


G 


07 

07 

0107 

12-7 

12-7 

H 

H 


H 


10 

10 

0110 

12-8 

12-8 

I 

I 


I 


11 

11 

0111 

12-9 

12-9 

J 

J 


J 


12 

12 

0112 

11-1 

11-1 

K 

K 


K 


13 

13 

0113 

11-2 

11-2 

L 

L 


L 


14 

14 

0114 

11-3 

11-3 

H 

M 


n 


15 

15 

0115 

11-4 

11-4 

H 

N 


N 


16 

16 

0116 

11-5 

11-5 

0 

0 


0 


17 

17 

0117 

11-6 

11-6 

P 

P 


p 


20 

20 

0120 

11-7 

11-7 

Q 

Q 


Q 


21 

21 

0121 

11-8 

11-8 

R 

R 


R 


22 

22 

0122 

11-9 

11-9 

S 

S 


s 


23 

23 

0123 

0-2 

0-2 

T 

T 


T 


24 

24 

0124 

0-3 

0-3 

U 

U 


U 


25 

25 

0125 

0-4 

0-4 

V 

V 


V 


26 

26 

0126 

0-5 

0-5 

W 

w 


u 


27 

27 

0127 

0-6 

0-6 

X 

X 


X 


30 

30 

0130 

0-7 

0-7 

Y 

Y 


Y 


31 

31 

0131 

0-8 

0-8 

1 

Z 


Z 


32 

32 

0132 

0-9 

0-9 

0 

0 


0 


33 

33 

0060 

0 

0 

1 

1 


1 


34 

34 

0061 

1 

1 

2 

2 


2 


35 

35 

0062 

2 

2 

3 

3 


3 


36 

36 

0063 

3 

3 

4 

4 


4 


37 

37 

0064 

4 

4 

5 

5 


5 


40 

40 

0065 

5 

5 

6 

6 


6 


41 

41 

0066 

6 

6 

7 

7 


7 


42 

42 

0067 

7 

7 

8 

8 


8 


43 

43 

0070 

8 

8 

9 

9 


9 


44 

44 

0071 

9 

9 

+ plus 

+ 

plus 

+ 

plus 

45 

45 

0053 

12 

12-8-6 

- minus 

- 

minus 

- 

minus 

46 

46 

0055 

11 

11 

* asterisk 

★ 

asterisk 

« 

asterisk 

47 

47 

0052 

'J- 

1 

op 

11-8-4 

/ stash 

/ 

s lash 

/ 

s lash 

50 

50 

0057 

0-1 

0-1 

C left paren. 

( 

left paren. 

( 

left paren. 

51 

51 

0050 

0-8-4 

12-8-5 

) right paren. 

) 

right paren. 

) 

right paren. 

52 

52 

0051 

12-8-4 

11-8-5 

$ ctolLar 

$ 

dollar 

$ 

dollar 

53 

53 

0044 

11-8-3 

11-8-3 

= equal to 

= 

equal to 

= 

equal to 

54 

54 

0075 

8-3 

8-6 

space 


space 


space 

55 

55 

0040 

no punch 

no punch 

f comma 

/ 

coirra 

/ 

comma 

56 

56 

0054 

0-8-3 

0-8-3 

. period 


period 


period 

57 

57 

0056 

■ 

12-8-3 

12-8-3 

= equivalence 

n 

number 

n 

number 

60 

60 

0043 

0-8-6 

8-3 

C left bracket 

i 

left bracket 

L 

1. bracket 

61 

61 

0133 

8-7 

12-8-2 
or 12-0^^^ 

1 right bracket 

I 

right bracket 

I 

r. bracket 

62 

62 

0135 

0-8-2 

11-8-2 
or 11 -O^tt 

X percent'^'^ 

X 

percent'^'^ 

X 

percent 

63 

63 

0045 

8-6 

0-8-4 
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TABLE A-2. LOCAL BATCH DEVICE CHARACTER SETS (Contd) 


CDC 

Graphic 

(64-Character 

Set) 

ASCII 

Graphic 

(64-Character 

Set) 

ASCII 

Graphic 
(95-Character 
Set) 

Octal 

6-Bit 

Display 
Code 

Octal 

6/12-Bit 

Display 

Code^ 

Octal 

12-Bit 

ASCII 

Code 

Card Keypunch Code 

026 

029 

t not equal 

" quote 

" quote 

64 

64 

0042 

8-4 

8-7 

(-► concat. 

underline 

underline 

65 

65 

0137 

0-8-5 

0-8-5 

V logical OR 

! exclamation 

! exclamation 

66 

66 

0041 

11-0 

12-8-7 

A logical AND 

& ampersand 

S ampersand 

67 

67 

0046 

0-8-7 

12 

t superscript 

* apostrophe 

* apostrophe 

70 

70 

0047 

11-8-5 

8-5 

4 subscript 

? question 

? question 

71 

71 

0077 

11-8-6 

0-8-7 

< less than 

< less than 

< less than 

72 

72 

0074 

12-0 

12-8-4 

> greater than 

> greater than 

> greater than 

73 

73 

0076 

11-8-7 

0-8-6 

< less/equal 

3 commercial at 


74 



8-5 

8-4 

> greater/equal 

\ reverse slant 

\ rev. slant 

75 

75 

0134 

12-8-5 

0-8-2 

^ logical NOT 

ci rcumf lex 


76 



12-8-6 

11-8-7 

; semicolon 

; semicolon 

; semicolon 

77 

77 

0073 

12-8-7 

11-8-6 



a coffll. at 


7401 

0100 





circumflex 


7402 

[E 





: colon^^ 


74041'^ 






grave accent 


7407 






a 


7601 






b 


7602 






c 


7603 

0143 





d 


7604 

0144 





e 


7605 

0145 





f 


7606 

0146 





9 


7607 

0147 





h 


7610 

0150 





i 


7611 

0151 





j 


7612 

0152 





k 


7613 

0153 





1 


7614 

0154 





m 


7615 

0155 





n 


7616 

0156 





0 


7617 

0157 





P 


7620 

0160 





q 


7621 

0161 





r 


7622 

0162 





s 


7623 

0163 




4 

t 


7624 

0164 





u 


7625 

0165 





V 


7626 

0166 





w 


7627 

0167 





X 


7630 

0170 





y 


7631 

0171 





z 


7632 

0172 





< left brace 


7633 

0173 





1 vert, line 


7634 

0174 





> right brace 


7635 

0175 





ti Ide 


7636 

0176 




^Generally available only on NOS, or through BASIC on NOS/BE. 


^^The interpretation of this character or code depends on its context. Refer to Character Set Anomalies 
in the text. 

^^^Available for input only, on NOS. 
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lAF supports both character mode and transparent 
mode transmissions through the network. These 
transmission modes are described under Network 
Access Method Terminal Transmission Code Sets in 
the Remote Batch Facility (RBF) reference manual. 
lAF treats character mode transmissions as coded 
character data; lAF converts these transmissions to 
or from either 6-bit or 6/12-bit display code. lAF 
treats transparent mode transmissions as binary 
character data; transparent mode communication 
between lAF and ASCII terminals using any parity 
setting occurs in the 12-bit ASCII code shown in 
table A-1. 


Local Batch Users 

Table A-2 lists the CDC graphic 6A-character set, 
the ASCII graphic 64-character set, and the ASCII 
graphic 95-character set. This table also lists 
the code sets and card keypunch codes (026 and 029) 
that represent the characters. 


The 64-character sets use display code as their 
code set; the 95-character set uses 12-bit ASCII 
code. The 95-character set is composed of all the 
characters in the ASCII 128-character set that can 
be printed at a line printer (refer to Line Printer 
Output). Only 12-bit ASCII code files can be 
printed using the ASCII graphic 95-character set. 
To print a 6/12-bit display code file (usually 
created in lAF ASCII mode), the user must convert 
the file to 12-bit ASCII code. To do this, the NOS 
FCOPY control statement must be issued. The 
95-character set is represented by the 12-bit ASCII 
codes OOAOg through 0i76g. 


Line Printer Output 

The batch character set printed depends on the 
print train used on the line printer to which the 
file is sent. The following are the print trains 
corresponding to each of the batch character sets: 




Print 

Character Set 


Train 

CDC graphic 64 

-character set 

596-i 

ASCII graphic 

64-character set 

596-5 

ASCII graphic 

95-character set 

596-6 


The characters of the default 596-1 print train are 
listed in the table A-2 column labeled CDC Graphic 
(6^-Character); the 596-5 print train characters 
are listed in the table A-2 column labeled ASCII 
Graphic (64-Character); and the 596-6 print train 
characters are listed in the table A-2 column 
labeled ASCII Graphic (95-Character). 


If a transmission error occurs during the printing 
of a line, NOS prints the line again. The CDC 
graphic print train prints a concatenation 
symbol ( ) in the first printable column of a 

line containing errors. The ASCII print trains 
print an underline instead of the concatenation 
symbol, 


If an unprintable character exists in a line (that 
is, a 12-bit ASCII code outside of the range 
0040g through 0176g), the number sign 0) 
appears in the first printable column of a print 
line and a space replaces the unprintable character. 


Punched Card Input and Output 

Under NOS, coded character data is exchanged with 
local batch card readers or card punches according 
to the translations shown in table A-2, As 
indicated in the table, additional card keypunch 
codes are available for input of the ASCII and CDC 
characters ] and [. The 95-character set cannot be 
read or punched as coded character data. 


Depending on an installation or deadstart option, 
NOS assumes an input deck has been punched either 
in 026 or 029 keypunch code (regardless of the 

character set in use). The alternate keypunch 
codes can be specified by a 26 or 29 punched in 
columns 79 and 80 of any 6/7/9 card or 7/8/9 card. 
The specified code translation remains in effect 
throughout the job unless it is reset by 

specification of the alternate code translation on 
a subsequent 6/7/9 card or 7/8/9 card. 

NOS keypunch code translation can also be changed 
by a card containing a 5/7/9 punch in column 1. A 
blank (no punch) in column 2 indicates 026 
conversion mode; a 9 punch in column 2 indicates 

029 conversion mode. The conversion change remains 
in effect until another change card is encountered 
or the job ends. 

The 5/7/9 card also allows literal input when 

4/5/6/7/8/9 is punched in column 2, Literal input 
can be used to read 80-coluinn binary character data 
within a punched card deck of coded character data. 


Literal cards are stored with each column in a 
12-bit byte (a row 12 punch is represented by a 1 
in bit 11, row 11 by bit 10, row 0 by bit 9, and 
rows 1 through 9 by bits 8 through 0 of the byte), 
16 central memory words per card. Literal input 
cards are read until a card identical to the 
previous 5/7/9 card (4/5/6/7/8/9 in column 2) is 
read. The next card can specify a new conversion 
mode. 
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Remote Batch Users 


When card decks are read from remote batch devices, 
the ability to select alternate keypunch code 
translations depends upon the remote terminal 
equipment• 


NOS Usage 

Remote batch terminal line printer, punched card, 
and plotter character set support is described 
under Input Deck Structure in the Remote Batch 
Facility reference manual. RBF supports only 
character mode transmission to and from consoles 
through the network. Character mode is described 
under Network Access Method Terminal Transmission 
Code Sets in the Remote Batch Facility reference 
manual. 


NOS/BE Usage 

Remote batch terminal line printer and punched card 
character set support Is described in the INTERCOM 
reference manual. 


Magnetic Tape Users 

Coded character data to be copied from mass storage 
to magnetic tape is assumed to be represented in 
display code. NOS converts the data to external 
BCD code when writing a coded 7-track tape and to 
ASCII or EBCDIC code (as specified on the tape 
assignment statement) when writing a coded 9-track 
tape. 


Because only 63 characters can be represented in 
7-track even parity, one of the 64 display codes is 
lost in conversion to and from external BCD code. 
Figure A-1 shows the differences in conversion that 
depend on which character set (63 or 64) the system 
uses. The ASCII character for the specified 
character code is shown in parentheses. The output 
arrow shows how the display code changes when it is 
written on tape in external BCD. The input arrow 
shows how the external BCD code changes when the 
tape is read and converted to display code. 


63"Character Set 

Display Cod6 External BCD Display Code 

00 16 (%) 00 

33 (0) Output 12 CO) Input 33 CO) 

63 C:) -12 CO) -33 (0) 


64-Character Set 

Display Code External BCD Display Code 

00 C:) 12 CO) 33 CO) 

33 CO) Output 12 CO) Input 33 CO) 

63 C%) -16 CX) — 63 CX) 


Figure A-1. Magnetic Tape Code Conversions 


Tables A-3 and A-4 show the character set 
conversions for nine-track tapes. Table A-3 lists 
the conversions to and from 7-bit ASCII character 
code and 6-bit display code. Table A-4 lists the 
conversions between 8-bit EBCDIC character code and 
6-bit display code. Table A-5 shows the character 
set conversions between 6-blt external BCD and 
6-bit display code for seven-track tapes. 

If a lowercase ASCII or EBCDIC code is read from a 
9-track coded tape, it is converted to its 
uppercase 6-bit display code equivalent. To read 
and write lowercase ASCII or EBCDIC characters, the 
user must assign the tape in binary mode and then 
convert the binary character data. 

During binary character data transfers to or from 
9-track magnetic tape, the 7-bit ASCII codes shown 
in table A-3 are read or written unchanged; the 
8-bit hexadecimal EBCDIC codes shown in table A-4 
also can be read or written unchanged. ASCII and 
EBCDIC codes cannot be read or written to 7-track 
magnetic tape as binary character data. 

Tables A-6 and A-7 list the magnetic tape codes and 
their punch code equivalents on IBM host computers. 

Two CDC utility products, FORM (not supported on 
SCOPE 2) and the 8-Bit Subroutines, can be used to 
convert to and from EBCDIC data. Table A-7 
contains the octal values of each EBCDIC code 
right-justified in a 12-bit byte with zero fill. 
This 12-bit EBCDIC code can also be produced using 
FORM and the 8-Bit Subroutines. 
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TABLE A~3. ASCII 9~TRACK CODED TAPE CONVERSION 


ASCII 

Display 

Code"'"^ 

ASCII 

Display 

Code'^'^'f 

Code 

Conversion^ 

Character and 

Code Conversion'*^'^ 

Code 

Conversion^ 

Character and 
Code Conversion^ 


Char 

Code 

(Hex) 

Char 

ASCII 

Char 

Code 

(Octal) 


Char 


Char 


Code 

(Octal) 

20 

space 

00 

NUL 

space 

55 

40 

3 

60 

• 

a 

7A 

21 

1 

7D 

> 

! 

66 

41 

A 

61 

a 

A 

01 

22 

II 

02 

SIX 

It 

64 


B 

62 

b 

B 

02 

23 

n 

03 

ETX 

n 

60 


C 

63 

c 

C 

03 

24 

s 

04 

EOT 

s 

53 

44 

D 

64 

d 

0 

- 94 

25 

X 

05 

ENQ 

X 

63 

45 

E 

65 

e 

E 

05 

25 

X 

05 

ENQ 

space 

55 

46 

F 

66 

f 

F 

06 

26 

ft 

06 

ACK 

& 

67 

47 

G 

67 

9 

6 

07 

27 

1 

07 

BEL 

1 

70 

48 

H 

68 

h 

H 

10 

28 

( 

08 

BS 

( 

51 

49 


69 

i 


11 

29 

) 

09 

HT 

) 

52 

4A 


6A 

j 


12 

2A 

★ 

OA 

LF 

* 

47 

4B 


6B 

k 


13 

2B 

+ 

OB 

VT 

+ 

45 

4C 


6C 

1 


14 

2C 

r 

OC 

FF 


56 

4D 

H 

60 

m 


15 

2D 


OD 

CR 


46 

4E 

N 

6E 

n 

N 

16 

2E 


OE 

SO 


57 

4F 


6F 

0 


17 

2F 

/ 

OF 

SI 

/ 

50 

50 


70 

P 


20 

30 

0 

10 

DLE 

0 

33 

51 


71 

q 


21 

31 

1 

11 

DC1 

1 

34 

52 

R 

72 

r 

HS 

22 

32 

2 

12 

DC2 

2 

35 

53 

S 

73 

s 

S 

23 

33 

3 

13 

DC3 

3 

36 

54 

T 

74 

t 

T 

24 

34 

4 

14 

DC4 

4 

37 

55 

U 

75 

u 

U 

25 

35 

5 

15 

NAK 

5 

40 

56 


76 

V 


26 

36 

6 

16 

SYN 

6 

41 

57 


77 

w 


27 

37 

7 

17 

ETB 

7 

42 

58 


78 

X 


30 

38 

8 

18 

CAN 

8 

43 

59 


79 

y 


31 

39 

9 

19 

EH 

9 

44 

5A 


7A 

z 


32 

3A 

: 

1A 

SUB 

: 

00 

5B 

c 

1C 

FS 

c 

61 

Displi 

ay code 00 is undefined at si 

ites using 

the 

5C 

\ 

7C 

1 

\ 

75 

63-character set. 




50 

c 

01 

SOH 

3 

62 

3A 


1A 

SUB 


63 

5E 


7E 

m 


76 

3B 

/ 

IB 

ESC 


77 

5F 


7F 

DEL 


65 

3C 

< 

7B 

■C 

< 

72 







3D 

= 

ID 

GS 

= 

54 







3E 

> 

IE 

RS 

> 

73 







3F 

7 

IF 

US 

7 

71 


■ 






^When these characters are copied from or to a ta(>e, the characters remain the same and the code changes 
from/to ASCII to/from display code- 


^^These characters do not exist in display code. When the characters are copied from a tape^ each ASCII 
character is changed to an alternate display code character. The corresponding codes are also changed. 
Example: When the system copies a lowercase a, 61-|6, from tape, it writes an uppercase A, Olg. 

A display code space always translates to an ASCII space. 
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TABLE A-A. EBCDIC 9-TRACK CODED TAPE CONVERSION 


EBCDIC 


play 

dettt 

EBCDIC 

Display 

Codettt 

Code 

Conversion^ 

Character and 

Code Conversion^^ 

Dis 

Co 

Code 

Conversion^ 

Character and 

Code Conversion^^ 

Code 

(Hex) 

Char 


Char 


Code 

(Octal) 

Code 

(Hex) 

Char 


Char 

m 

Code 

(Octal) 

40 

space 



space 

55 

C6 

F 

86 

f 


06 

4A 

d 



C 

61 

C7 

G 

87 

9 


07 

48 

• 




57 

C8 

H 

88 

h 

H 

10 

4C 

< 



< 

72 

C9 


89 

i 


11 

4D 

( 

Bfl 

BS 

( 

51 

D1 


91 

j 


12 

4E 

+ 


VT 

+ 

45 

D2 


92 

k 


13 

4F 

1 

DO 

> 

1 

66 

D3 


93 

1 


14 

50 

& 

2E 

ACK 

& 

67 

D4 


94 

m 

M 

15 

5A 

1 

01 

SOH 

1 

62 

D5 

N 

95 

n 

N 

16 

5B 

$ 

37 

EOT 

% 

53 

D6 


96 

0 


17 

5C 

* 

25 

LF 

* 

47 

D7 


97 

P 


20 

5D 

) 

05 

HT 

> 

52 

D8 


98 

q 


21 

5E 

/ 

27 

ESC 


77 

D9 


99 

r 


22 

5F 

“1 

A1 


/ 

76 

EO 

\ 

6A 

1 

\ 

75 

60 

- 

OD 

CR 


46 

E2 

S 

A2 

s 

s 

23 

61 

1 

OF 

SI 

1 

50 

E3 

T 

A3 

t 

T 

24 

6B 

r 

OC 

FF 

r 

56 

E4 

U 

A4 

u 

u 

25 

6C 

X 

2D 

ENQ 

X 

63 

E5 


A5 

V 


26 

6C 

X 

2D 

END 

space 

55 

E6 


A6 

w 


27 

6D 


07 

DEL 


65 

E7 


A7 

X 


30 

6E 

“ 

IE 

IRS 

> 

73 

E8 


A8 

y 


31 

6F 

? 

IF 

lUS 

7 

71 

E9 


A9 

z 


32 

7A 

: 

3F 

SUB 

; 

00 

FO 

0 

10 

DLE 


33 

Display code 00 is undef 

ined at si 

tes using 

the 

FI 

1 

11 

DC1 

1 

34 

63“character set. 




F2 


12 

DC2 


35 

7A 

: 

3F 

SUB 


63 

F3 


13 

TM 


36 

7B 

n 

03 

ETX 

tf 

60 

F4 


3C 

DC4 


37 

7C 

a 

79 

\ 

a 

74 

F5 

5 

3D 

NAK 

5 

40 

7D 

1 

2F 

BEL 

1 

70 

F6 

6 

32 

i SYN 

6 

41 

7E 



IGS 

=: 

54 

F7 

7 

26 

1 ETB 

7 

42 

7F 



STX 

■1 

64 

F8 

8 

18 

CAN 

8 

43 

Cl 



a 

A 


F9 

9 

19 

EM 

9 

44 

C2 



b 









C3 



c 









C4 



d 









C5 



e 

E 









^AU EBCDIC codes not listed translate to display code SSg (space). A display code space always 
translates to an EBCDIC space- 


^^These characters do not exist in display code. When the characters are copied from a tape, each EBCDIC 
character is changed to an alternate display code character. The corresponding codes are also changed. 
Example: When the system copies a lowercase a, 81^^, from tape, it writes an uppercase A, OI 3 . 

^^^When these characters are copied from or to a tape, the characters remain the same (except EBCDIC codes 
^^16^ ^^16^ and 5F-|6) and the code changes from/to EBCDIC to/from display code. 
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TABLE A-S. 7-TRACK CODED TAPE CONVERSIONS 


External 

BCD 

ASCII 

Character 

Octal Display 

Code 

External 

BCD 

ASCII 

Character 

Octal Display 

Code 

01 

1 

34 

40 

• 

46 

02 

2 

35 

41 

J 

12 

03 

3 

36 

42 

K 

13 

04 

4 

37 

43 

t 

14 

05 

5 

40 

44 

n 

15 

06 

6 

41 

45 

H 

16 

07 

7 

42 

46 

0 

17 

10 

8 

43 

47 

p 

20 

11 

9 

44 

50 

Q 

21 

12^ 

0 

33 

51 

R 

22 

13 

Si 

54 

52 

1 

66 

14 

II 

64 

53 

$ 

53 

15 

a 

74 

54 

* 

47 

16^ 

X 

63 

55 

1 

70 

17 

c 

61 

56 

7 

71 

20 

space 

55 

57 

> 

73 

21 

/ 

50 

60 

+ 

45 

22 

S 

23 

61 

A 

01 

23 

T ^ 

24 

62 

B 

02 

24 

U 

25 

63 

C 

03 

25 

V 

26 

64 

D 

04 

26 

u 

27 

65 

E 

05 

27 

X 

30 

66 

F 

06 

30 

Y 

31 

67 

G 

07 

31 

Z 

32 

70 

H 

10 

32 

3 

62 

71 

I 

11 

33 


56 

72 

< 

72 

34 

( 

51 

73 

• 

57 

35 


65 

74 

) 

52 

36 

? 

60 

75 

\ 

75 

37 

E 

67 

76 

A, 

76 




77 

/ 

77 

^As explaine 

d in the text of 

this appendix^ conversion of these codes depends on whether the tape is 

being read 

or written. 
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TABLE A”6. AMERICAN NATIONAL STANDARD CODE FOR INFORMATION INTERCHANGE (ASCII) 
PUNCHED CARD CODES AND EBCDIC TRANSLATION 
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DIAGNOSTICS 


B 


Diagnostic messages can either appear in the dayfile 
or are intermixed with Update output in the output 
file. In addition to detecting errors, Update 
detects overlapping corrections when the EXTOVLP 
installation option has been assembled. 


DIAGNOSTIC MESSAGES 

All diagnostic messages that can be issued during an 
Update run are listed in alphabetic order in 
table B-1, One of the following codes is included 
for each diagnostic: 

Type Meaning 

I An informative message; processing con¬ 

tinues. 

N A nonfatal error; processing continues. 

F A fatal error; processing is terminated. 

OVERLAPPING CORRECTIONS 

Update can detect four overlapping correction 
situations. When any of these types are detected. 
Update prints the line in error with the words 
TP.n OVIJ* appended on the far right of this line. 
Type n is one of the following: 


Type Meaning 

1 Two or more modifications are made to one 
line by a single correction set. 

2 A modification attempts to activate an 
already active line. 

3 A modification attempts '"to deactivate an 
already Inactive line. 

4 A line is inserted after a line which is 
inactive on the old program library and 
is inactive on the new program library. 


The listing of overlap lines is controlled by list 
option 3. 

Detection of an overlap does not necessarily indi¬ 
cate a user error. Overlap messages are advisory, 
and they point to conditions in which the 
probability of error is greater than normal. If any 
overlap condition is encountered, a dayfile message 
is printed. 

Type TP. 2 and TP. 3 are detected by comparing 
existing correction history bytes with those to be 
added. Complex operations involving YANK and PURGE 
might generate these overlap messages even though no 
overlap occurs. 


TABLE B-1. DIAGNOSTICS 


Message 

Type 

Significance 

Action 

A OPTION INVALID WITH RANDOM 

OLDPL OR SEQUENTIAL NEWPL 

F 

The old program library is 
not sequential or the new 
program library is not ran¬ 
dom or is not on a random 
device for a sequential- 
to-random copy. 

Correct the error. 

***ADDFILE DIRECTIVE INVALID ON 
REMOTE FILE*** 

F 

The ADDFILE directive cannot 
be used in the file specified 
by a READ directive. 

Remove the ADDFILE directive 
from the file specified by the 
READ directive. 

***ADDFILE FIRST LINE MUST BE 

DECK OR COMDECK*** 

F 

The first line on the file 
specified by the ADDFILE 
directive is not a DECK or 
COMDECK directive. 

Correct the error. 

***ALL YANK, SELYANK, YANKDECK, 
AND CALL DIRECTIVES AFFECTED 

HAVE BEEN CHANGED*** 

I 

If Update changes any identi¬ 
fiers during a merge, it also 
changes the corresponding 

YANK, SELYANK, YANKDECK, and 

CALL directives. 

None. 

B OPTION INVALID WITH SEQUENTIAL 
OLDPL 

E 

The old program library is not 
random for a random-to- 
sequential copy. 

Do not specify B on the control 
statement. 


60449900 E 


B-1 









TABLE B--1. DIAGNOSTICS (Contd) 


Message 

Type 

Significance 

Action 

***BAD ORDER ON YANK 

DIRECTIVE*** 

N 

Identifiers separated by a 
period on the YANK directive 
are in the %7rong order. 

Correct the order of the 
identifiers. 

***LINE NUMBER ZERO OR INVALID 
CHARACTER IN NUMERIC FIELD*** 

F 

Sequence number field on a 
correction directive is 

erroneous. 

Correct the sequence number. 

***DIRECTIVE INVALID OR 

MISSING*** 

F 

Update detected a format error 
on a directive, deleted a 
directive that was unrecogniz¬ 
able, or detected an illegal 
file name. Illegal operations 
such as INSERT prior to an 

IDENT could also have been 
attempted. 

Correct the error. - - 

***COPY TO EXTERNAL FILE NOT 
ALLOWED WHEN READING ALTERNATE 
INPUT UNIT*** 

N 

No copy is made. 

Correct the error. 

COPYING INPUT TO TEMPORARY 

NEWPL 

I 

A sequential new program 
library was requested on a 
creation run. 

None. 

COPYING OLDPL TO A RANDOM FILE 

I 

The old program library is 
being copied to a random file- 

None. 

CREATING NEW PROGRAM LIBRARY 

I 

Indicates that a new program 
library is being created* 

None. 

***DECK NAME ON ABOVE LINE NOT 

I 

When a DECLARE directive is in 

Add appropriate DECLARE direc- 

LAST DECLARED DECK*** 


effect, only line Images 
belonging to decks specified 
can be modified or referenced. 

tives or remove directives 
that reference non-declared 
decks. 

***DECK SPECIFIED ON MOVE OR 

COPY DIRECTIVE NOT ON OLDPL, 
DIRECTIVE WILL BE IGNORED*** 

I 

The specified deck will not be 
moved or copied. 

Correct the error. 

DECK STRUCTURE CHANGED 

I 

A deck has been moved or 
deleted. 

None. 

***DO/DONT IDENT idname IS NOT 
YANKED/YANKED NULL DO/DONT*** 

I 

A DO directive, to negate the 
effect of a YANK, references 
an identifier that has been 
yanked; or a DONT directive, 
to restore a YANK, references 
an identifier that was already 
yanked. 

None. 

***DUPLICATE DECK dname NEWPL 
ILLEGAL*** 

F/N 

Update encountered an active 
DECK or CCMDECK directive 
that duplicates a previous 
directive. This condition is 
fatal if a new program library 
is being created; nonfatal if 
a new program library is not 
being created. 

Chaxige one of the deck n^es. 

***DUPLICATE FILE NAME OF file, 
JOB ABORTED*** 

f 

The same file name has been 
assigned to two Update files. 

Change one of the file names. 

***DUPLICATE IDENT CHANGED TO 
ident*** 

N 

Update changed a duplicate 
Identifier name to a unique 
one. 

None. 
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TABLE B~l. DIAGNOSTICS (Contd) 


Message 

Type 

Significance 

Action 

***DUPLICATE IDENT NAME*** 

F 

During a merge run. Update 
encountered a duplicate 
identifier name that it could 
not make unique. 

Change one of the identifiers. 

***DUPLICATE IDENT NAME IN 
ADDFILE*** 

F 

The name of a correction set 
to be added as a result of an 
ADDFILE directive duplicates 
a correction set name on the 
old program library. 

Change the name of the 
correction set. 

DUPLICATE SECONDARY OLDPL 

IGNORED 

I 

Two secondary old program 
libraries have the same name. 

Correct the error or ignore. 

***ERROR. NO PERMISSION TO 

WRITE NEWPL*** 

F 

Both MODIFY and EXTEND 
permission must be present 
to overwrite a permanent 
(direct access) file, or a 
write ring must be in place 
to store the information. 

Attach file with correct 
access permissions. The 
tape requested or labeled for 
output must have a write ring. 
(Refer to the NOS, NOS/BE, 
or SCOPE reference manuals.) 

***ERROR***NOT ALL MODS WERE 
PROCESSED*** 

F 

All changes indicated in the 
input stream were not pro¬ 
cessed . 

Make sure that names specified 
on correction directives corre¬ 
spond to identifiers on the old 
program library (or on the 

COMPILE directive if in quick 
mode). 

***ERROR. WIDTH EXCEEDS 256 
CHARACTERS*** 

N 

Total of statement width plus 
ident field width is greater 
than 256 characters on *WIDTH 
statement. 

Correct *WIDTH statement. 

***FILENAME OF file IS TOO LONG, 
UPDATE ABORTED*** 

F 

A file name exceeds seven 
characters. 

Correct the file name. 

***FILENAME ON ABOVE DIRECTIVE 
GREATER THAN SEVEN 

CHARACTERS*** 

F 

A file name exceeds seven 
characters. 

Correct the file name. 

FILE NAME ON UPDATE CONTROL 
STATEMENT GR 7 CHARACTERS 

F 

A file name on the UPDATE 
control statement is greater 
than seven characters. 

Correct the file name. 

G AND 0 FILES CANNOT HAVE SAME 
FILENAME 

F 

The G and 0 control statement 
options specify the same file 
name. 

Change one of the names. 

GARBAGE IN OLDPL HEADER, 

UPDATE ABORTED 

. F 

Invalid data was found in the 
random index. 

Rerun job/re-create program 
library. If the problem still 
exists, follow site-defined 
procedures for reporting soft¬ 
ware errors or operational 
problems. 

***IDENT DIRECTIVE MISSING, 

NO NEWPL REQUESTED, DEFAULT 
IDENTIFIER OF .NO.ID. USED*** 

I/F 

If no new program library is 
generated, then a correction 
set need not be introduced by 
an IDENT directive. The iden¬ 
tifier .NO.ID. is used. 

Add IDENT directive if new 
program library is to be 
generated. 

IDENT xxxxx WILL NOT BE 

PROCESSED 

I 

Named correction set not 
processed because dependency 
condition (K or U parameter on 
the IDENT directive) has not 
been met. 

None. 
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TABLE B-1. DIAGNOSTICS (Contd) 


Message 

Type 

Significance 

Action 

***IDENT LONGER THAN NINE 
CHARACTERS*** 

F 

An identifier can only have up 
to nine characters. 

Correct the identifier. 

***IDENTIFIERS SEPARATED BY 

PERIOD IN WRONG ORDER*** 

F 

The specified identifiers are 
not in the correct order. 

Switch the identifiers. 

***ILLEGAL CONTROL STATEMENT 

IN ADDFILE*** 

F 

ADDFILE insertions cannot con¬ 
tain correction directives. 

Remove the correction 
directives. 

IMPROPER MASTER CHARACTER 

CHANGED TO char 

N 

The character specified on the 
* control statement parameter 
is not the same as the master 
control character on the old 
program library. 

Use the same master control 
character as on the old program 
library. 

INSUFFICIENT FIELD LENGTH, 

UPDATE ABORT 

F 

The table manager ran out of 
room for internal tables. 

Allocate more field length. 

***IT MAY EXIST IN A DECK 

NOT MENTIONED ON A COMPILE 
DIRECTIVE*** 

F 

An identifier references a 
line in a deck not specified 
on a COMPILE directive (only 
if in quick mode). 

Correct the error. 

***INVALID NUMERIC FIELD*** 

F 

The directive does not contain 
required numeric field. 

Correct the directive. 

***LENGTH ERROR ON OLDPL. 

UNUSABLE OLDPL OR HARDWARE 
ERROR*** 

F 

Line length on old program 
library is greater than the 
maximum allowed or is less 
than one. 

Rerun job. If problem still 
exists, then recreate the pro¬ 
gram library. 

***LISTED BELOW ARE ALL IDENT 
NAMES WHICH WERE CHANGED 

DURING THE MERGE*** 

I 

Update changes any duplicate 
identifiers to make them 
unique when merging two pro¬ 
gram libraries. 

None. 

***NEW IDENT ON CHANGE 

DIRECTIVE IS ALREADY KNOWN*** 

F 

An attempt was made to change 
a correction set identifier to 
one already in existence. 

Correct the error. 

***NO ACTIVE LINES WERE 

FOUND WITHIN THE COPY RANGE. 

NULL COPY*** 

N 

All line images within the 
specified range are inactive. 

None. 

***NO DECK NAME ON DECK 
DIRECTIVE*** 

F 

No name was specified on the 
DECK directive. 

Specify a name. 

NO INPUT FILE, Q MODE, UPDATE 
ABORT 

F 

In quick mode, Update relies 
on the input file to determine 
what is written to the compile 
file. 

Put appropriate COMPILE 
directives in the input file. 

NO OLDPL, NOT CREATION RUN, 
UPDATE ABORT 

F 

No old program library was 
supplied on a non-creation 
run. 

Correct the error. 

***NULL ADDFILE*** 

I 

The first read on the file 
specified by ADDFILE encounter¬ 
ed an end-of-record. If the 
input file was specified, the 
first read encountered an 
illegal directive. 

Correct the error. 

***NULL IDENT*** 

F 

An identifier was not found on 
a directive where one was 
expected. 

Correct the directive. 


B-4 


60449900 E 







TABLE B-i. DIAGNOSTICS (Contd) 


Message 

Type 

Significance 

Action 

***NULL DECK NAME*** 

F 

During ADDFILE or a CREATION 
run, Update encountered a DECK 
or COMDECK directive that did 
not have a name. 

Correct the directive. 

***0LDPL-READ ERROR - ATTEMPTING 
RECOVERY*** 

***READ RECOVERED - DATA LOST 
BEFORE THE FOLLOWING LINE*** 

-line Image- 

F 

A parity error or other error 
has occurred while processing 
an old program library. As a 
result, Update is uncertain of 
the position of the old pro¬ 
gram library. When Update 
finds the next valid line fol¬ 
lowing the error, the second 
message and the image of that 
line are printed. 

Rerun the job. If the U option 
is used, line images might be 
lost on the NEWPL. 

OLDPLS HAVE DIFFERENT 

CHARACTERS SETS 

I 

The merging of two old program 
libraries with different char¬ 
acter sets is not allowed. 

Use program libraries with the 
same character set. 

***0UTPUT LINE LIMIT EXCEEDED. 
LIST OPTIONS 3 AND 4 DEFEATED*** 

N 

Update output exceeds the 
line limit specified by 
default or by the LIMIT 
directive. 

Use the LIMIT directive to 

increase one unit. 

PLS HAVE DIFFERENT CONTROL 
CHARACTERS, ABORT 

F 

The merging of two program 
libraries with different 
control characters is not 
allowed. 

Use program libraries with the 
same control characters. 

***PREMATURE END OF RECORD ON 

OLD PROGRAM LIBRARY*** 

F 

A PRU of level 0 was 
encountered in the line image. 

Rerun the job. If error still 
exists, recreate the program 
library. 

READING INPUT 

I 

The input file is being read 
by Update. 

None. 

***RECURSIVE CALL ON COMDECK 
dname IGNORED. FATAL ERROR*** 

F 

A common deck has called 
itself or common decks that 
contain calls to the specified 
common deck. 

Correct the error. 

SECONDARY OLDPL NOT RANDOM 

F 

Secondary old program 
libraries must be random. 

Use random secondary old 
program libraries. 

***SEQUENCE NUMBER EXCEEDS 
131071*** 

F 

The proper range of sequence 
numbers is 1 through 131071, 

Correct the error. 

STACK DEPTH EXCEEDED 

F 

Stack in which line images are 
placed became full while 
processing a BEFORE or ADDFILE 
directive. 

Follow site-defined proced¬ 
ures for reporting software 
errors or operational prob¬ 
lems. (increase RECURDEP). 

TABLE MANAGER LOGIC ERROR 

F 

There is not enough table 
space to accommodate the old 
program library tables. 

Increase field length. 

***THE ABOVE CALLED COMMON 

DECK WAS NOT FOUND*** 

F 

The called common deck could 
not be found. 

Check the spelling of the deck 
name. If creating a program 
library with calls to secondary 
old program libraries, set C=0 
on the UPDATE control 
statements. 

***THE ABOVE CARD AFFECTS A 

DECK OTHER THAN THE DECLARED 
DECK*** 

I 

Corrections are restricted 
to the named deck. 

Change the declared deck or 
correct the identifier name. 
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TABLE B-1. DIAGNOSTICS (Contd) 


Message 

Type 

Significance 

Action 

ABOVE DIRECTIVE IS 

ILLEGAL DURING A CREATION 

RUN*** 

F 

A directive that is not 
allowed on a creation run was 
encountered. 

Remove the illegal directive. 

***THE ABOVE DIRECTIVE IS 

ILLEGAL IN AN ALTERNATE FILE, 
IGNORED*** 

N 

Directives *READ, *SKIP, or 
*REW1ND are illegal in an 
alternate file. 

Remove the il1eg al direc tive s. 

***THE ABOVE DIRECTIVE IS 

ILLEGAL AFTER A DECK HAS BEEN 
DECLARED*** 

N 

CHANGE. PURGE, and YANK 
directives are illegal after a 
deck has been specified on a 
DECLARE directive. They are 
ignored. 

Remove the illegal directives. 

***THE ABOVE LISTED DIRECTIVES 
CANNOT EXIST IN THE YANK DECK 

AND HAVE BEEN PURGED DURING 
EDITING*** 

I 

Only YANK, YANKDECK, SEL- 
YANK, and DEFINE directives 
are kept in the YANK$$$ deck. 

None. 

***THE ABOVE OPERATION IS NOT 
LEGAL WHEN REFERENCING THE 

YANK DECK*** 

F 

The specified operation is 
illegal when referencing the 
YANK$$$ deck. 

Correct the error. 

***THE ABOVE SPECIFIED LINE 

WAS NOT ENCOUNTERED*** 

F 

Update could not locate the 
specified line on the old pro¬ 
gram library. 

Make sure that the correct 
identifier is specified. 

***THE INITIAL LINE OF THE COPY 
RANGE WAS NOT FOUND. NULL 

COPY*** 

N 

No copy was made. 

Make sure that the correct 
identifier is specified. 

***THE TERMINAL LINE OF THE 

COPY RANGE WAS NOT FOUND. 

COPY ENDS AT END OF SPECIFIED 
DECK*** 

I 

The last line specified was 
not found; the rest of the 
deck was copied. 

Make sure that the correct 
identifier is specified. 

***THE TERMINAL LINE SPECIFIED 

WAS NOT ENCOUNTERED*** 

F 

While processing a line range. 
Update could not locate the 
last line of the range. 

Make sure that the correct 
identifier is specified. 

THIS UPDATE REQUIRED n WORDS OF 
CORE 

I 

It took n words of memory for 
the update. 

None • 

***TOO MANY CHBS — INCREASE 
L.CHB*** 

F 

Correction history bytes 
exceed the specified limit of 
lOOg for a line. 

Increase of value of L.CHB 
in Update and reinstall it. 

TOO MANY SECONDARY OLDPLS 

SPECIFIED 

F 

Up to seven secondary old 
program libraries can be 
specified. 

Specify seven or fewer 
secondary old program 
libraries. 

***UNBALANCED TEXT/ENDTEST 
DIRECTIVES*** 

N 

TEXT/ENDTEXT directives 
encountered in the run were 
not matching pairs. 

Make TEXT/ENDTEXT directives 
matching pairs, 

***UNKNOWN IDENTIFIER idname*** 

F 

A correction directive 
references an identifier not 
found in the directory- 

Make sure that the correct 
identifier is specified. 

UPDATE COMPLETE 

I 

The update is completed. 

None. 

UPDATE CONTROL STATEMENT 

ERROR(S) 

F 

1 

The UPDATE control statement 
contains unacceptable 
parameters. The erroneous 
par ame ters are listed on the 
next line. 

Correct the erroneous 
parameters. 
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TABLE B-1. DIAGNOSTICS (Contd) 


Message 

Type 

Significance 

Action 

UPDATE CREATION RUN 

I 

This Update run was a creation 
run. 

None. 

WAITING FOR A5000B WORDS 

I 

Update is waiting for the 
operating system to allocate 
enough memory* 

None. 

***OLDPL CHECKSUM 

ERROR*** 

F 

At least one updated deck 
from the old program library 
is bad• 

Rerun Job. If problem still 
exists, follow site-defined 
procedures for Teporting soft¬ 
ware errors or operational 
problems. 

***YANK, SELYANK, OR YANKDECK 
ident NOT KNOWN*** 

N 

The identifier referenced on a 
YAIUC, SELYANK, or YANKDECK has 
probably been purged; this 
applies to lines already on 
the library* 

Remove the yank directive 
from the YANK$$$ deck. 

***deckname IS NOT A VALID DECK 
NAME*** 

F 

A deck name has 1 through 9 
characters; legal characters 
are: A through Z, 0 through 

9, and +“*/()$*. 

Correct the deck name. 

***n ERRORS IN INPUT*** 

I 

Update encountered n fatal 
errors in the input stream* 
Processing continues in order 
to detect additional errors* 

This message is issued only if 
the U parameter is specified 
on the control statement■ 

None. 

***n ERRORS IN INPUT, NEWPL, 
COMPILE, SOURCE SUPPRESSED*** 

I 

Update encountered n fatal 
errors in the input stream- 
Processing continues in order 
to detect errors. A new 
program library, a compile 
file, and a source file are 
not generated. 

None. 

n ERRORS IN UPDATE INPUT 

I 

First pass of Update pro¬ 
cessing encountered n fatal 
errors while reading a 
correction set. 

None. 

n DECLARE ERRORS 

I 

Indicates the number of 
directives that reference 
line images in decks not 
specified on DECLARE 
directives. 

None. 

n FATAL ERRORS 

I 

Indicates the number of errors 
that caused Update to abort * 

None. 

n NONFATAL ERRORS 

I 

Indicates the number of errors 
that did not cause Update to 
abort* 

None. 

n OVERLAPPING CORRECTIONS 

I 

A correction set changed the 
status of some lines more than 
once or referenced an inactive 
line image. 

None. 

n UPDATE ERRORS, JOB ABORTED 

I 

Errors were encountered in 
reading the input file. 

None. 
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GLOSSARY 


C 


ASCII - 

American Standard Code for Information Inter¬ 
change. ASCII input and output codes for Update 
are 8-bit characters right-justified in a 12-bit 
byte. 

Common Deck - 

A deck that is written on a compile file as a 
result of a CALL directive• The COMDECK 
directive introduces a common deck. 

Compile File - 

The file generated by Update that contains line 
images restored to a format that is acceptable 
to a compiler or assembler. 

Copy Run - 

An Update run that performs a sequential-to- 
random or random-to-sequential copy of a program 
library. Contrast with creation run and 
correction run. 

Correction History Byte - 

A byte added to a line image by Update each time 
the status of the line image changes. The 
correction history byte tells Update whether or 
not a line image is active or inactive and which 
correction set modified the line image. A 
maximum of lOOB correction history bytes may 
exist for each line. 

Correction Run - 

An Update run in which changes can be made to a 
program library. Contrast with copy run and 
creation run. 

Correction Set - 

A set of directives and text that direct Update 
to modify a program library. The IDENT 
directive introduces a correction set. 

Creation Run - 

An Update run that constructs a program 
library. It is the original transfer of lines 
into Update format. Contrast with copy run and 
correction run. 

Deck - 

A deck consists of a DECK or COMDECK directive 
and all text and directives until the next DECK 
or COMDECK directive. It is the smallest unit 
that can be extracted from a program library. 

Deck List - 

A list internal to Update that contains the 
names of all decks in the program library and 
the location of the first word for each deck. 

Directory - 

A list that contains one entry for each DECK, 
COMDECK, and IDENT directive that is used for 
the program library. 
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Full Update Mode - 

An Update run in which the F parameter is 
selected on the control statement causing Update 
to process all decks on the library. Contrast 
with normal selective mode and quick Update mode. 

Identifier - 

The name of a deck, common deck, or correction 
set. 

Input File - 

The user-supplied file or part of the job deck 
that contains the input stream of Update 
directives and text. 

Known - 

The status of a deck name or identifier that is | 
on the primary old program library. The deck 
name must be in the deck list on the primary old 
program library and an identifier must be in the 
directory on the primary old program library. 

Line Identifier - 

The combination of identifier and sequence 
number that uniquely identifies each line image | 
in a program library. 

Master Control Character - 

A character in column 1 that informs Update 
that the line contains a directive. | 

Merge File - 

The file that contains a program library to be 
merged with the old program library into a new 
program library. 

New Program Library - 

The program library either automatically gen- I 
erated by a creation run or optionally generated I 
by a correction run. | 

Normal Selective Mode - 

An Update run in which the F and Q options are 
not selected on the control statement. All 
decks specified on COMPILE directives as well as 
all corrected decks are processed. Contrast 
with full Update mode and quick Update mode. 

Old Program Library - 

The program library to be modified. 

Output File - 

The print file generated by Update that contains | 
the status information produced during Update 
execution. It is in a form suitable for 

printing. 

Program Library - 

The file generated by an Update run that 
contains decks of line images that, can be I 

manipulated by Update. | 
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Pullmod File - 

A file that contains directives and text or 
re-created correction sets specified on PULLMOD 
directives. 

Quick Update Mode - 

An Update run in which the Q option is selected 
on the control statement. Only decks specified 
on COMPILE directives and called common decks 
are processed. Contrast with full Update mode 
and normal selective mode. 

Secondary Old Program Library - 

A program library from which decks on the old 
program library can call common decks. 

Sequence Number - 

A number supplied by Update that uniquely 
identifies a line image. 

Source File - 

An optional file generated by Update that uses 
line images of an input stream to generate a new 
program library. 

System-Logical Record - 

Under NOS/BE, a data grouping that consists of 
one or more PRUs terminated by a short PRU or 
zero-length PRU. These records can be trans¬ 


ferred between devices without loss of 
structure. Equivalent to a logical record under 
NOS. Table C-1 shows equivalency under 
SCOPE 2. 


TABLE C-1. RECORD TYPE UNDER SCOPE 2 


Type 

Level 

Equivalency 

RT-W 

0 thru Ibg 

end-of-section 

RT-W 

1^8 

end-of-partition 

RT-S 

0 thru 17g 

end-of-record 

RT-Z 

0 thru 17g 

end-of-section 

BT«C 

0 thru 17g 

end-of-section 


Unknown - 

The status of a deck name or Identifier that is 
not on the old program library. A deck name or 
identifier that is purged has the status of 
unknown. 
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FILE FORMAT AND STRUCTURE 


D 


The files generated and used by Update have formats 
determined by both the operating system in use and 
the user. This appendix describes default file 
formats, allowed file formats, and the inter¬ 
changeability of files among operating systems. 
Table D-1 summarizes file structure according to 
the operating system used. 


LIBRARY FILE FORMATS 

Update can create and maintain library files in two 
distinctly different formats; random and sequen¬ 
tial. These formats are described in detail 
below. Random format should be used whenever 
possible because it can be processed substantially 
faster than sequential format. 


RANDOM FORMAT 

On a random format library, each deck is a 
system-logical record as shown in figure D-1. The 
deck records are followed by separate records 
containing the deck list, the directory, and the 
random index. 


Random Index 

The random index tells Update the beginning point 
and length of the directory and the deck list. The 
index also contains such information as the master 
control character and the character set used when 
the library was generated. Random index format is 
shown in figure D-2. 

Two copies of the random index are generated under 
SCOPE 2 because Update generates another copy when 
it closes the file. The closing of the file is a 
process internal to Update. 



Deck^ 


Deck2 


Deckn 


Deck List 


Directory 


EACH DECK IS 
A LOGICAL 
RECORDt 


FIRST ENTRY 
POINTS TO 
YANK$$$ 

DECK 


SCOPE 2 Headertt 


Random Index 


Random Index 


-EOI- 


tFor SCOPE 2, each deck is a section. 
ttHeader applies to SCOPE 2 only. 


Under SCOPE 2, Update adds a 2-word header to the 
random index that indicates the number of words in 
the index. SCOPE 2 header format is shown in 
figure D-3. 


Copying to Tape 

Random program libraries should be copied to tape 
through Update parameters. To copy a random 
program library to tape under NOS or NOS/BE, use 
the UPDATE control statement; 

UPDATE(B,P=plname,N=lfn) 

where plname is the library name and Ifn is the 
tape file. To copy the library back to mass 
storage, use: 

UPDATE(A,P=1fn,N-newp1) 


Figure D-1. Random Program Library Format 


where Ifn is the tape file and newpl is the new 

program library name. 

Under SCOPE 2, use the UPDATE control statement: 
UPDATE(F,P=pIname,N=lfn) 

to copy a random program library to tape. The 
program library name is plname and Ifn is the tape 
file. To copy the library back to mass storage, 

use: 

UPDATE(F,P-lfn,N»newpl) 

where Ifn is the tape file and newpl is the new 

program library name. 
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TABLE D-1. FILE STRUCTURE VERSUS OPERATING SYSTEM 



NOS/BE 

NOS 

SCOPE 2 

Update 

File 

Tape 

Mass Storage 

Tape 

Mass Storage 

Tape 

Mass Storage 

P=0Lr)PL 

Binary 

SI tape 

Random or 
sequential 

Binary 

SI tape or 
I tape 

Random or 
sequential 

Binary, sequential^ 
RT«W or S 

Random: RT-W, 
unblocked 

Sequential: RT«W, 
unblocked 

RT-W 

N-NEWPL 

Binary 

SI tape 

Random or 

W - sequential 

Binary 

SI tape or 
I tape 

Random 

W - sequential 

Binary, sequential 
RT-W or S 

Random if unblocked 

Sequential if blocked 
or if W specified 
on Update control 
statement. 

RT-W,unblocked by 
default. 

RT«blocked W or S; 
specified through 
FILE control state¬ 
ment. 

Cannot be blocked if 
random. 

C-COMPILE 

Binary 

Sequential 

RT«Z 

Binary 

Sequential 

RT«Z 

RT«W,I blocked. 

Other types (F or 

Z only) determined 
by FILE control 
statement. 

RT-W,unblocked. 

Other types (F or 

Z only) determined 
by FILE control 
statement. 

1=INPUT 

Binary 

Sequential 

RT-Z 

Binary 

Sequential 

RT*Z 

RT«W,I blocked. 

Other blocking or 
RT«Z, FL < 256 
through FILE con¬ 
trol B ta tement. 

RT-W,unblocked 

RT-W blocked or RT-Z, 
FL £ 256 through FILE 
control statement. 

O-OUTPUT 

Binary 

Sequential 

RT*Z 

Binary 

Sequential 

RT-Z 

RT«W,I blocked. 

Other types 
po 8 sible through 
FILE control 

statement. 

RT-W,unblocked 

S^SOURCE 

Binary 

Sequential 

RT«Z 

Binary 

Sequential 

RT«Z 

RT*W,I blocked. 

Other blocking or 
RT«Z, FL £ 256 
through FILE con¬ 
trol statement. 

RT-W,unblocked 

RT-W blocked or RT-Z 

If specified 
through FILE con¬ 
trol statement. 

*READ Ifn or 
*ADDFILE Ifn 

Binary 

Sequential 

RT=Z 

Determined 
by REQUEST! 
or LABEL | 
control 

statement 

Sequential 

RT«Z 

RT-W,I blocked. 

Other blocking or 
RT-Z, FL < 256 
through FILE con¬ 
trol statement. 

_1 

RT-W,unblocked 

RT-W blocked or RT-Z 
if specified 
through FILE con¬ 
trol statement. 


tRandom files can be put on tape by copying the file to tape- To access this file, it must first be copied 
to a W unblocked file. W records are 5120 characters in length- SCOPE 2 Update checks for presence of 
directory header containing DIRECT$ to identify random file and for presence of CHECK in word 1 of sequen¬ 
tial file. If both tests fail, library format is unacceptable. Random format library must be unblocked W 
records. 


NOTE 

Update uses 7000 record manager for I/O, but Update does not use 6000 record manager 
(BAM) Basic Access Method. A FILE control statement can be used with SCOPE, but this 
control statement is ignored under NOS and NOS/BE. 
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59 

47 

29 

24 23 17 

11 

5 0 

7000 

dLL 

dlLra 

unused 

dirL 

dirra 

unused 

m 

X 

Lab 

y 

c 

LabeL 


LabeL 

(contd) 






70CX3 
dlL 
dl Ira 
dirt 
di rra 


Lab 


Identifies random directory record. 

Length of the deck List in words. 

Random address of first word of deck List- 

Length of directory in words- 

Random address of first word of directory- 

Indicates presence of deck bits in deck List 

1 Deck bits present, 

other Deck bits not present. 

Character set identifier determined by IP.CSET pararaeter- 


3 (368) 

4 (378) 

7 (428) 

8 ( 438 ) 

LabeL fLag: 


nonzero 

0 


IP.CSET is set for a 63-character set. 

IP.CSET is set for a 64-character set. 

IP.CSET is set for 63-character set pLus ASCII- 

IP.CSET is set for 64-character set pLus ASCII. 


Words 3 and 4 contain tape LabeL. 
Words 3 and 4 not present. 


SCOPE 2 does not recognize tape LabeLs. 

Indicates which character set was used when the Library was generated. 

Y or nuLL 64-character set used, 
other 63-character set used. 

Indicates master controL character in use when the Library was created. 


Figure D-2. Random Index Format 


59 17 0 


DIRECTS 

unused 

n 

n 

Number of words in the random index- 



Figure D-3- SCOPE 2 Random Index Header Format 
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SEQUENTIAL FORMAT 


Update optionally creates new program libraries in 
sequential format. On magnetic tape, a sequential 
library (I tape format on NOS, SI tape format on 
NOS/BE, or RT-S on SCOPE) is written as one record 
in binary (figure D-4). The first word in the 
file is a display code key word (figure I>“5); the 
second is a counter word containing the number of 
deck names in the deck list and the count of 
correction set identifiers in the directory 
(figure D-6). The last word in the file is a 
checksum (figure D-7). 


YANK$$$ DECK 

The YANK$$$ deck is automatically created on a 
creation run as the first deck on the program 
library. It does not have a DECK line as its first 
line image. On correction runs, Update inserts 
into the YANK$$$ deck any YANK, SELYANK, YANKDECK, 
and DEFINE directives that it encounters during the 
read-input-stream phase. These directives acquire 
identification and sequence information from the 
correction set from which they originate. On a 
merge, the two YANK$$$ decks are merged into a 
single deck. 

Although the YANK$$$ deck as a whole cannot be 
I yanked or purged, lines in the deck can be deleted, 
yanked, or purged. If information other than the 
four directive types mentioned inadvertently gets 
into the YANK$$$ deck, this information can be 
purged through the E option on the Update control 
I statement or through the SELYANK directive. The 
YANK$$$ deck is maintained in display code. 


DECK LIST 

The deck list is a table that contains an entry for 
each deck on the program library. Each entry on a 
sequential program library consists of one word 
containing the deck name; bit three is reserved for 
the deck bit that indicates whether or not the deck 
is a common deck. Each deck list entry on a random 
program library consists of two words as shown in 
figure D-8. The deck list is maintained in display 
code. 


DIRECTORY 

The directory is a table that contains one entry 
for each DECK, COMDECK, and IDENT that has ever 
been used for this library. Directory entries each 
consist of one word containing the 1 through 9 
character identifier in display code, 
left-justified with zero fill. Correction set 
identifiers and deck names are listed 
chronologically as they are introduced into the 
library. The directory is maintained in display 
code. 

A deck name that has been purged remains in the 
table although it is not printed on the listable 
output file. The purged deck names are not removed 
from the table unless the E (edit) parameter is 
specified on the Update control statement. 

The number of identifiers in the directory is 
limited by the amount of central memory (or small 
core memory) available. 


Display Code Key Word 


Counter Word 


Directory 


Deck List 


YANK$$$ Deck 


Deck 1 


Deck 2 



Figure D-4. Sequential Program 
Library Format 


Each directory entry has the format shown in 
figure D-9. For a purged identifier, bits 59 
through 6 are zeros, and bits 5 through 0 contain 
a 20g. 


COMPRESSED TEXT FORMAT 

Text is an indefinite number of words that contain 
a correction history and the compressed image of 
each line in the deck. Information for each line | 
is in the format shown in figure D-10. 


OLD SEQUENTIAL FORMAT 

Update accepts library files in the old 
(pre-SCOPE 3.4) Update sequential format as shown 
in figure D-11. These libraries resemble the new 
sequential format but do not contain the CHECK word 
or checksum, and the text format and correction 
history bytes are different. Word 2 on the new 
format is the same as word 1 on the old format. 
Update no longer generates this obsolete sequential 
format. 
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59 

29 

24 

23 

17 

11 

5 0 

CHECK 

00 

m 

X 

lab 

D 

c 


CHECK 


Lab 


Identifies the file as being a sequential file. 

Indicates presence of deck bits in deck list: 

1 Deck bits present, 

other Deck bits not present. 

Character set identifier determined by IP.CSET parameter: 


3 CSbg) 

4 ( 378 ) 

7 (428) 

8 (438) 

Label flag: 
L 

null 


IP.CSET is set for a 63-character set. 

IP.CSET is set for a 64-character set. 

IP.CSET is set for 63-character set plus ASCII. 

IP.CSET is set for 64-character set plus ASCII. 


Indicates labeled tape. 
Indicates unlabeled tape. 


SCOPE 2 does not recognize tape labels. 

Indicates which character set used when the library was generated: 

Y or null 64-character set used, 
other 63-character set used. 

Indicates master control character in use when the library was created. 


Figure D-5. Display Code Key Word Format 


59 


35 


17 


unused 


idcount 


dcount 


idcount Number of identifiers in the directory, 
dcount Number of deck names in the deck list. 


Figure D-6, Counter Nord Format 



checksum Count of bits in the program Library. 

Figure D-7. Checksum Format 
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59 

29 

5 

3 

0 

dname 


B 

3 

unused 

ra 


dname 1 through 9 alphanumeric character deck name obtained from DECK or COMDECK 
directive when deck was placed on library. The first dname is YANK$$S. 

un Unused. 

d Deck bit. Indicates kind of deck, 

0 Common deck. 

1 Regular deck. 

ra Random address of first word of compressed text for the deck. 


Figure D-8. Random Program Library Deck List Format 


59 

5 0 


identifier 

unused 
or 20 q 



i 


Figure D-9. Directory Format 


59 58 


53 


35 


17 


c 

stat 

wc 

seqnum 

chb 1 

c 

unused 

chb 2 

chb 3 

chb 4 

1 

r ._.. 1 

p 

unused 

chb n-2 

chb n-"1 

chb n 


compressed line 


c Correction history byte flag. Indicates the last word containing 

correction history bytes. 

0 Not last word. 

1 Last word. 


Figure D-10. Compressed Text Format on Program Library (Sheet 1 of 3) 
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stat 


Line status: 


58 56 54 53 



a Activity bit: 

0 Line IS inactive. 

1 Line is active. 

b Character set aode: 

0 Character set is display code. 

1 Character set is ASCII. 

d Yank deck indicator (*DECK directive only): 

0 Deck not yanked. 

1 Deck yanked. 

Number of words of compressed text for this line, excluding words 
containing correctipn history bytes. 

Sequence number of line (octal) according to position in deck or 
correction set identified by chb 1. 

Correction history byte- Update creates a byte for each correction 
set that changes the status of the line. The format of chb is: 

17 15 0 

y a identno 


y Yank bit: 

0 Line not yanked. 

1 Line has been yanked. 

a Activity bit: 

0 Correction set deactivated the line. 

1 Correction set activated the line. 

identno Index to the entry in the directory that contains the name 
of the correction set or deck that introduced the line or 
changed the line status. 

The coR^ressed image of the line in display code. Single and double 
spaces are unaltered. Three or more embedded spaces are replaced in 
the image as follows: 

3 spaces replaced by 0002g 

4 spaces replaced by OCXBg 

5 spaces replaced by 0004g 


64 

spaces 

replaced by CX)77g 

65 

spaces 

replaced by 0077558 

66 

spaces 

replaced by 007755558 

67 

spaces 

replaced by CH)7700028, etc. 


Trailing spaces are not considered as embedded and are not included 
in the line image. A 4-digit octal code 0000 or word count Cwc) 
reached marks the end of the line. This is conditional on the 
CHAR64 option. 


Figure D-10. Compressed Text Format on Program Library (Sheet 2 of 3) 


Compressed 
line in 
display 
code 
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When the fuLL-character set instaLLatiwi option is assembled, a byte 
of 0001 represents a colon. 

Compressed The compressed image of the line in ASCII. One or more spaces are 
Line in replaced in the image as follows: 

ASCII code 

1 space replaced by 040^ 

2 spaces replaced by OOlg 

3 spaces replaced by OO 23 

4 spaces replaced by OOSg 


31 spaces replaced by 036g 

52 spaces replaced by 037^ O 4 O 3 

33 spaces replaced by 037^ 0418 

0005 CNUL) replaced by 0378 0008 

0018CSH) replaced by 0378 ^^8 


0378CUS) replaced by 0378 0378 

Compressed ASCII characters are stored as 7-1/H eight-bit characters 
per 60-bit word, with multiple blanks compressed and trailing blanks 
removed. A four-digit octal code 00008 warks the end of the Line, 
if the code occurs before the end of the Last word is reached. Only 
the lower 8 bits of each 12-bit byte are saved; the upper 4 bits are 
ignored, unless expanding a compressed line image. When expanding 
an ASCII compressed line image, the upper 4 bits of each character 
are set to zero, unless the character is NUL (0008). "the 
character is NUL, the 12-bit value 40008 returned. Characters 
in the range 0418 to 3778 are stored unchanged. 


Figure D-10. Compressed Text Format on Program Library (Sheet 3 of 3) 


INTERCHANGEABILITY OF 
LIBRARIES 

When the random format libraries have been copied 
to tapes, the libraries have limited inter¬ 
changeability among the operating systems. This 
interchangeability is shown in table D-2. 

The control statements COPY, COPYBF, COPYBR, 
COPYCF, or COPYCR should not be used on random 
access files on NOS/BE or on SCOPE since these 
operating systems might not recognize that the 
copied file is a random access file. 

Sequential program libraries are interchangeable 
among operating systems when they are system- 
logical records (Record Manager type S records). 


COMPILE FILE FORMAT 

Through control statement parameters, the user can 
specify whether the text on the compile file is to 
be compressed or expanded, and sequenced or 
unsequenced. The expanded compile file format for 
each line consists of 72 or 80 columns of data | 
followed by 0 to 18 columns of sequence informa¬ 
tion. The maximum size of a line image is 90 | 
columns. 


0-8 



Figure D-11. Old Sequential Program 
Library Format 
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TABLE D-2. FILE INTERCHANGEABILITY 


System That Generated 
Random Library on 

Tape 

System to Read 

Random Library From 
Tapet 

NOS 

NOS/BE 

SCOPE 2 . 

NOS 

Yes 

No 

No 

NOS/BE 

Yes 

Yes 

Nott 

SCOPE 

No 

No 

Yes 


^A yes indicates the tape can be read; a no 
indicates it cannot. 


^Must be copied to unblocked mass storage 
file when read in. 


Update attempts to place sequence information in 
the columns remaining in the line image after the 
data columns have been allocated- When the data 
field is 72 and the line image is 90 columns, 
column 73 is blank and 17 columns are available for 
sequencing information. In this case, the 1 to 9 
character identifier is left-justified in 
column 7A, and the sequence number is right- 
justified in column 86- 

When the data field is 72 and the line image is 80 
columns, 8 columns are available for sequencing 
information. If the data field is 80 and the line 
image is 90, 10 columns are available for 

sequencing information. In either of these cases, 
if the identifier and sequence number exceed the 
field. Update truncates the least significant 
(right-most) characters of the identifier leaving 
the sequence number intact. 


If the data field and line image are both 80, the 
compile file output cannot have sequence infor¬ 
mation appended. 

The width statement overrides the values specified 
by D and 8. The table D-3 shows the equivalence of 
the D and 8 parameter options to the *WIDTH 
directive. 


TABLE D-3. WIDTH DIRECTIVE EQUIVALENCE 


TO D AND 8 

OPTIONS 

D and 8 Options 

*WIDTH Equivalent 

neither D nor 8 option 

*WIDTH 72,14 

D option 

*WIDTH 80,10 

8 option 

*WIDTH 72,8 

D,8 option 

*WIDTH 80,0 


The examples in figure D-12 show how Update 
positions sequencing information for the various 
control statement options. 

In addition, figure D-13 shows possible widths of 
the identification field and the positioning of the 
identifier name and sequence number. The total 
length possible for the identification field is 
17. If the identification field length is larger 
than 17, extra blanks will be inserted between the 
sequence fields. 

If the 80- or 90-character line image on the 
compile file has two blanks as the last two 
characters, these are converted to a 0000 line 
terminator and the line image is 8 (or 9) words 
long. If the last two columns do not con- 


NORMAL COMPILE OUTPUT-^ 

WITH D OPTION-s— 

WITH 8 OPTION-^ 



■ 

■ 

■ 

■ 

■ 

80 

■ 

■ 

■ 

■ 

■ 

86 

■ 

■ 

■ 

90 

1 

A 

s 

E 

D 

B 

N 

C 

H 

B 

B 

1 

B 

B 

B 

B 

B 

B 

B 









D 

B 

B 

B 

B 

B 

B 

B 

B 

B 

B 

E 

V 

E 

1 

1 

D 

B 













HU 


Figure D-12. Sequencing Format for Compile File 


♦WIDTH 80,5-► 

♦WIDTH 80,15-► 

♦WIDTH 80,20-► 

80 

■ 

■ 

■ 

■ 

85 

■ 

■ 

■ 

■ 

90 

■ 

1 

1 

1 

95 

■ 

■ 

■ 

■ 

100 



B 

E 

B 

E 

3 


















S 


fl 

B 

N 

B 

B 





B 

B 

B 







B 

B 

B 

B 

B 

E 

B 

B 

B 

B 

B 









3 





Figure D-13. Sequence Number Overlay 
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tain blanks, a word containing 8 blanks and a 
zero-byte line terminator are added, thus making 
the line image 9 (or 10) words long. This same 
procedure is used for creation of the source file. 


The format of the compressed compile file is shown 
in figure D-14. The first word is a loader prefix 
table ( 773 ). Compressed format is generated 
through the X option on the UPDATE control 
statement• 



sequence fieLd^* 17 characters comprising card columns 74 through 90. Column 73 is 
always blank. 

nw^ Binary number of words in compressed line. 

compressed Line^* Each 00 character is replaced by the 12-bit value 0001^ and three or 
more consecutive blanks (to a maximum of 64) are replaced by a 12-bit 
value 0002 through 0077g, a single blank is represented in display 
code C55g); two consecutive blanks are represented by the 12-bit 
value 5555g. if the last word is not full/ it is padded on the 
right with binary zeros. Because word count nw is present/ an extra 
all-zero word is not required to guarantee 12 zero bits- *WIDTH 
directives are ignored with compressed compile files. The full line 
image is always present/ and the sequence field information is always 
a full 17 characters- 


Figure D-14. Compile File Compressed Format 
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INDEX 


A parameter 4-1 
ABBREV dIrective 3-14 
ADDFILE directive 

Description 3-1, 3-5 
Examples 5-4 


B parameter 4-1 
BEFORE directive 3-6 


C parameter 4-1 
CALL directive 

Description 3-11 
Example 5-2 
CHANGE directive 3-6 
Character sets A-1 
COMDECK directive 

Description 1-2, 3-4, 3-5 
Example 5-1 
Comments 3-3, 3-16, 4-7 
Common deck-s (see Decks) 

COMPILE directive 3-11 
Compile file (see Files) 

Control Statement (see UPDATE control statement) 
COPY directive 

Description 3-6 
Example 5-2 
Copy run 1-3, 2-2 
Correction history bytes 1-3 
Correction run 

Description 1-2 
Example 5-2 
Files 2-1 

Correction set 1-2, 3-7, 3-8 
Creation run 

Description 1-2 
Example 5-1 
Files 2-1 

CWEOR directive 3-1, 3-3, 3-4, 3-11 


D parameter 4-2 
Debugging 4-6 
DECK directive 

Description 1-2, 3-5 
Example 5-1 
Deck list 1-2, D-4 
Decks 

Common 

Calling 3-11 
Description 1-2, 3-4, 3-5 
Example 5-1 
Regular 

Description 1-2, 3-4 
Example 5-1 

DECLARE directive 3-1, 3-15 
DEFINE directive 3-15 
DELETE directive 

Description 3-7 
Example 5-2 
Diagnostic Messages B-1 


Directives 

Compile file 2-3, 3-11 
Correction 3-5 
Deck identifying 3-4 
Description 1-1, 1-2, 3-1 
File manipulation 3-13 
Format 3-3 

Input stream control 3-14 
Special 3-15 
Directory 1-2, 3-8, D-4 
DO directive 


Description 

3-12 

Example 5-4 


DONT directive 


Description 

3-12 

Example 5-4 


E parameter 4-3 


END directive 3- 

-15 

ENDIF directive 


Description 

3-12 

Example 5-4 


ENDTEXr directive 

3- 


F parameter 4-3 
Files 

Compile 

Control statement parameters 4-1, 4-6 
Description 1-1, 2-3 

Format D-8 
Input 

Control statement parameter 4-3 
Description 1-2, 2-1 

Example 5-1 
Li stable output 2-4 

Merge 

Control statement parameter 4-4 
Description 1-2, 2-4 
New program library 

Control statement parameter 4-5 
Description 1-1, 2-3 
Old program library 

Control statement parameter 4-5 
Description 1-1, 2-3 

Output 

Control statement parameter 4-4 
Description 1-1, 2-4 

Pullmod 

Control statement parameter 4-3 
Description 1-2, 2-4 

Example 5-4 

Secondary old program library 

Control statement parameter 4-5 
Description 2-3, 3-11 

Source 

Control statement parameter 4-6 
Description 1-2, 2-4 

Full mode (see Update mode) 


G parameter 4-3 
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H parameter 4-3 


I parameter 

Description 4-3 
Example 5-1 
IDENT directive 3-7 
IF directive 

Description 3-12 
Example 5-4 
Input file (see Files) 
Input stream 1-1, 2-2 
INSERT directive 

Description 3-8 
Example 5-2 


K parameter 4-3 


L parameter 4-4 
LIMIT directive 3-15 

Line identifier 1-1, 3-4 

LIST directive 3-14 


M parameter 4-4 

Master control character 3-3, 4-6 
Merge file (see Files) 

MOVE directive 3-8 

N parameter 4-5 

New program library (see Files) 

NOABBREV directive 3-14 

NOLIST directive 3-14 

Normal selective mode (see Update mode) 

0 parameter 4-5 

Old program library (see Files) 

Output file (see Files) 

Overlapping Corrections B-1 


P parameter 4-5 

Primary input stream (see Input stream) 
Program library (see also Files) 

Auditing 4-3 
Editing 4-2 
Random and sequential 

Description 2-2, 4-2, 4-4, 4-5 
Format D-1 
PULLMOD directive 

Description 3-15 
Example 5-4, 5-5 
Pullmod file (see Files) 

PURDECK directive 

Description 3-8 
Example 5-3 
PURGE directive 

Description 3-9 
Example 5-2, 5-3 

Q parameter 4-5 

Quick mode (see Update mode) 


R parameter 4-5 

Random program library (see Program library) 
READ directive 3-13 
Regular deck (see Decks) 

RESTORE directive 3-9 
REWIND directive 3-13 


S parameter 4-6 

Secondary input stream (see Input stream) 
Secondary old program library (see Files) 
SELPURGE directive 
Description 3-9 
Example 5-3 
SELYANK directive 

Description 3-10 
Example 5-3 
SEQUENCE directive 3-10 

Sequential program library (see Program library) 
SKIP directive 3-14 
Source file (see Files) 


T parameter 4-6 
TEXT directive 3-14 


U parameter 4-6 
UPDATE control statement 
Description 4-1 
Examples 4-7 
Parameters 1-1, 4-1 
Update mode 

Full 1-3, 4-3 

Normal selective 1-3, 4-3, 4-5 
Quick 1-3, 2-4, 4-5 


W parameter 4-6 
WEOR directive 

Description 3-3, 3-4, 3-13 
Example 5-1 
WIDTH directive 

Description 3-13 


X parameter 4-6, D-10 


YANK directive 

Description 3-10 
Example 5-3 
YANKDECK directive 

Description 3-10 
Example 5-3 
YANK$$$ deck 1-2, D-4 


8 parameter 4-6 

/ comment directive 3-15 
/ parameter 4-7 

* parameter 4-6 


Index-2 
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